@kumwe/studio-protocol 0.1.0-alpha.5 → 0.1.0-beta.2

package/schemas/host-sequence-vector.schema.json

@@ -0,0 +1,342 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kumwe.org/studio/v1/host-sequence-vector.schema.json",
+  "title": "Studio canonical host sequence conformance vector",
+  "description": "A deterministic sequence of host-port invocations, settlements, logical-clock advances and renderer completions. Every stateful precondition is bounded JSON so another runtime can reproduce retries, rate-limit windows and in-flight cancellation without wall-clock sleeps or executable fixture callbacks.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "kind",
+    "id",
+    "description",
+    "profile",
+    "assertions",
+    "idempotencyPolicy",
+    "given",
+    "steps",
+    "expectFinal"
+  ],
+  "properties": {
+    "contractVersion": { "$ref": "common.schema.json#/$defs/contractVersion" },
+    "kind": { "const": "host-sequence-vector" },
+    "id": { "$ref": "common.schema.json#/$defs/stableId" },
+    "description": { "type": "string", "minLength": 1, "maxLength": 500 },
+    "profile": { "const": "studio.profile/host-baseline-v2" },
+    "assertions": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 12,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/assertion" }
+    },
+    "idempotencyPolicy": { "$ref": "#/$defs/idempotencyPolicy" },
+    "given": { "$ref": "#/$defs/given" },
+    "steps": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 24,
+      "items": {
+        "oneOf": [
+          { "$ref": "#/$defs/invokeStep" },
+          { "$ref": "#/$defs/settleStep" },
+          { "$ref": "#/$defs/advanceClockStep" },
+          { "$ref": "#/$defs/releasePreviewRenderStep" }
+        ]
+      }
+    },
+    "expectFinal": { "$ref": "#/$defs/finalState" }
+  },
+  "$defs": {
+    "assertion": {
+      "enum": [
+        "operation-id-mismatch-refusal",
+        "idempotent-in-flight-coalescing",
+        "idempotent-completed-replay",
+        "idempotency-changed-argument-refusal",
+        "idempotency-changed-context-refusal",
+        "idempotency-resource-scope-separation",
+        "canonical-number-equivalence",
+        "failed-attempt-retry",
+        "fixed-window-rate-limit",
+        "fixed-window-reset",
+        "in-flight-preview-cancellation",
+        "cross-context-cancellation-isolation",
+        "late-preview-result-discard"
+      ]
+    },
+    "idempotencyPolicy": {
+      "description": "The exact map key and canonical intent preimage used by this profile. Scope fields select an accepted record; the argument and listed semantic context fields form its canonical JSON fingerprint. Optional semantic fields that are absent are omitted, not serialized as null. Canonical JSON applies its number grammar, including normalization of negative zero to zero. Per-attempt request and trace correlation never affect intent.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "scopeFields",
+        "argumentCanonicalization",
+        "intentContextFields",
+        "absentOptionalFields",
+        "numberNormalization",
+        "excludedContextFields"
+      ],
+      "properties": {
+        "scopeFields": {
+          "const": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"]
+        },
+        "argumentCanonicalization": { "const": "canonical-json" },
+        "intentContextFields": {
+          "const": ["expectedRevision", "locale", "protocolVersion"]
+        },
+        "absentOptionalFields": { "const": "omit" },
+        "numberNormalization": { "const": "canonical-json" },
+        "excludedContextFields": { "const": ["requestId", "traceContext"] }
+      }
+    },
+    "port": {
+      "enum": [
+        "artifact",
+        "localization",
+        "media",
+        "model",
+        "permission",
+        "preview",
+        "recovery",
+        "resource",
+        "telemetry"
+      ]
+    },
+    "artifactSeed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "revision", "status"],
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "kind": { "enum": ["blueprint", "content-model", "entry"] },
+        "revision": { "$ref": "common.schema.json#/$defs/revision" },
+        "status": { "enum": ["archived", "draft", "in-review", "published", "retired"] }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "entry" } }, "required": ["kind"] },
+          "then": {
+            "properties": {
+              "status": { "enum": ["archived", "draft", "in-review", "published"] }
+            }
+          },
+          "else": {
+            "properties": { "status": { "enum": ["draft", "published", "retired"] } }
+          }
+        }
+      ]
+    },
+    "rateLimit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "operationId",
+        "maximumRequests",
+        "windowMilliseconds",
+        "retryAfterMilliseconds"
+      ],
+      "properties": {
+        "operationId": { "$ref": "host-operations.schema.json#/$defs/operationCapability" },
+        "maximumRequests": { "type": "integer", "minimum": 1, "maximum": 1000 },
+        "windowMilliseconds": { "type": "integer", "minimum": 1, "maximum": 86400000 },
+        "retryAfterMilliseconds": {
+          "description": "The retry delay at logical time zero after the fixed-window bound is reached. It equals the initial window duration.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 86400000
+        }
+      }
+    },
+    "given": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["artifacts", "permissions", "sessionGeneration"],
+      "properties": {
+        "artifacts": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/artifactSeed" }
+        },
+        "permissions": {
+          "type": "array",
+          "maxItems": 50,
+          "uniqueItems": true,
+          "items": { "$ref": "common.schema.json#/$defs/qualifiedName" }
+        },
+        "rateLimits": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/rateLimit" }
+        },
+        "sessionGeneration": { "$ref": "common.schema.json#/$defs/revision" }
+      }
+    },
+    "requestContext": {
+      "description": "The canonical host request envelope. Malformed single exchanges remain in the original host corpus; an intentional registered-capability mismatch is an executable invalid-request assertion here.",
+      "$ref": "host-request.schema.json#/$defs/requestContext"
+    },
+    "resultExpectation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["outcome"],
+      "properties": {
+        "outcome": { "const": "result" },
+        "revisionAdvancesFrom": { "$ref": "common.schema.json#/$defs/revision" },
+        "sameAs": { "$ref": "common.schema.json#/$defs/stableId" },
+        "value": { "enum": ["null", "rendered"] }
+      }
+    },
+    "errorExpectation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["outcome", "category", "retryable"],
+      "properties": {
+        "outcome": { "const": "error" },
+        "category": {
+          "enum": [
+            "cancelled",
+            "conflict",
+            "forbidden",
+            "incompatible",
+            "internal",
+            "invalid-request",
+            "limit-exceeded",
+            "not-found",
+            "rate-limited",
+            "unauthenticated",
+            "unavailable",
+            "validation-failed"
+          ]
+        },
+        "retryable": { "type": "boolean" },
+        "retryAfterMilliseconds": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 86400000
+        }
+      }
+    },
+    "expectation": {
+      "oneOf": [{ "$ref": "#/$defs/resultExpectation" }, { "$ref": "#/$defs/errorExpectation" }]
+    },
+    "invokeStep": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "id", "port", "operation", "context", "completion"],
+      "properties": {
+        "action": { "const": "invoke" },
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "port": { "$ref": "#/$defs/port" },
+        "operation": { "$ref": "common.schema.json#/$defs/localName" },
+        "context": { "$ref": "#/$defs/requestContext" },
+        "argument": { "$ref": "common.schema.json#/$defs/jsonValue" },
+        "completion": { "enum": ["pending", "settled"] },
+        "expect": { "$ref": "#/$defs/expectation" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "completion": { "const": "settled" } },
+            "required": ["completion"]
+          },
+          "then": {
+            "properties": { "expect": { "$ref": "#/$defs/expectation" } },
+            "required": ["expect"]
+          },
+          "else": { "not": { "required": ["expect"] } }
+        },
+        {
+          "if": {
+            "properties": {
+              "port": { "const": "preview" },
+              "operation": { "const": "render" }
+            },
+            "required": ["port", "operation"]
+          },
+          "then": {
+            "properties": {
+              "argument": { "$ref": "preview-message.schema.json#/$defs/render" }
+            },
+            "required": ["argument"]
+          }
+        }
+      ]
+    },
+    "settleStep": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "id", "invocation", "expect"],
+      "properties": {
+        "action": { "const": "settle" },
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "invocation": { "$ref": "common.schema.json#/$defs/stableId" },
+        "expect": { "$ref": "#/$defs/expectation" }
+      }
+    },
+    "advanceClockStep": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "id", "milliseconds"],
+      "properties": {
+        "action": { "const": "advance-clock" },
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "milliseconds": { "type": "integer", "minimum": 1, "maximum": 86400000 }
+      }
+    },
+    "releasePreviewRenderStep": {
+      "description": "A deterministic renderer completion injected after a prior preview.render invocation. It is a harness precondition, not a host port or transport operation.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "id", "invocation", "value"],
+      "properties": {
+        "action": { "const": "release-preview-render" },
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "invocation": { "$ref": "common.schema.json#/$defs/stableId" },
+        "value": { "$ref": "preview-message.schema.json#/$defs/rendered" }
+      }
+    },
+    "artifactFinalState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "status", "revisionFrom"],
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/stableId" },
+        "status": { "enum": ["archived", "draft", "in-review", "published", "retired"] },
+        "revisionFrom": { "$ref": "common.schema.json#/$defs/stableId" }
+      }
+    },
+    "recoveryFinalState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resourceContextKey", "value"],
+      "properties": {
+        "resourceContextKey": { "$ref": "common.schema.json#/$defs/stableId" },
+        "value": { "$ref": "common.schema.json#/$defs/jsonValue" }
+      }
+    },
+    "finalState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pendingPreviewRenders", "previewDeliveries"],
+      "properties": {
+        "artifacts": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/artifactFinalState" }
+        },
+        "recovery": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/recoveryFinalState" }
+        },
+        "pendingPreviewRenders": { "const": 0 },
+        "previewDeliveries": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "type": "string", "pattern": "^[a-f0-9]{64}(?![\\s\\S])" }
+        }
+      }
+    }
+  }
+}

package/schemas/host-vector.schema.json

@@ -133,6 +133,8 @@
               "enum": [
                 "artifact",
                 "artifact-references",
+                "content-model",
+                "content-models",
                 "media-asset",
                 "media-page",
                 "message-bundle",

package/schemas/manifest.json

@@ -1,10 +1,54 @@
 {
   "contractVersion": "0.1-draft",
   "epoch": "https://schemas.kumwe.org/studio/v1/",
+  "generator": {
+    "name": "@kumwe/studio/schema-manifest",
+    "version": "1.0.0"
+  },
   "kind": "schema-manifest",
   "schemas": [
     {
-      "digest": "sha256-sx4nxAo1fq7Mjp2J3gfsIWRq9vD6nkDDrc1PtWLzfNE=",
+      "digest": "sha256-nzk5hko590N58UQlQ04bR31Jk2pw+sDwXLJXu2re174=",
+      "file": "authoring-http-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-http-vector.schema.json"
+    },
+    {
+      "digest": "sha256-1G8TtRsEvzqO9ixuoaMRAOBJZ2FdSM82xLA6zziA5Rk=",
+      "file": "authoring-http.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-http.schema.json"
+    },
+    {
+      "digest": "sha256-WvSNMOQ3OZWs7ZKBCCRRwLtw5byZBtn6Rwvxz74vfAY=",
+      "file": "authoring-message-catalog.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-message-catalog.schema.json"
+    },
+    {
+      "digest": "sha256-/rKcDdqp9AomUUzMlcpUbEVUTTydH9rduu5BumhfN9s=",
+      "file": "authoring-save.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-save.schema.json"
+    },
+    {
+      "digest": "sha256-YOuMdnT6L/BkfGv9D9gqQjXP1yvriLufPLVKWeKmQh0=",
+      "file": "authoring-session.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-session.schema.json"
+    },
+    {
+      "digest": "sha256-N3sgQ/9iEAOvKwpkoRPbTeJF/KwK1kLWheMKuGRU+PY=",
+      "file": "authoring-target.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-target.schema.json"
+    },
+    {
+      "digest": "sha256-hZBNrpwHkLuUu/mPeU2UWtuOXfvZgrd8MO7vB9fJWog=",
+      "file": "authoring-web-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/authoring-web-vector.schema.json"
+    },
+    {
+      "digest": "sha256-GCk2z8XalwUUKM6R146c7WeCj3CY00kTMRKtPjaeehs=",
+      "file": "binding-projection-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/binding-projection-vector.schema.json"
+    },
+    {
+      "digest": "sha256-S3sx0m9PQs2vMFNvYIapBXc8W184cEng5MFF54C6RwQ=",
       "file": "block-definition.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/block-definition.schema.json"
     },
@@ -29,7 +73,7 @@
       "id": "https://schemas.kumwe.org/studio/v1/command.schema.json"
     },
     {
-      "digest": "sha256-htSwJXFIhBnC96NxNxKgr+h2Fbo/qg8/ydtwguXEesA=",
+      "digest": "sha256-O2nKQ4qeVaHzqM6pseB6R1NXflQyPd2TWzucR5Lf/Ss=",
       "file": "common.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/common.schema.json"
     },
@@ -64,12 +108,12 @@
       "id": "https://schemas.kumwe.org/studio/v1/host-capabilities.schema.json"
     },
     {
-      "digest": "sha256-6FWXIBdUaiuxpwLJUWnHxnRdcYmR6Ni6WWFCEQFekGw=",
+      "digest": "sha256-7tYC8PpuMQd3DHt4zrB3A+w5bZVMOman4gYvfugXdc8=",
       "file": "host-error.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-error.schema.json"
     },
     {
-      "digest": "sha256-dKcbTVV2gn4IWAAH1RMpK5Ve12V+RswsDuhlrC1Ohm4=",
+      "digest": "sha256-Sd/PcwJSh/qPuxVz7L1durLmavdALdCbya/BMMxzZvs=",
       "file": "host-operations.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-operations.schema.json"
     },
@@ -84,7 +128,12 @@
       "id": "https://schemas.kumwe.org/studio/v1/host-result.schema.json"
     },
     {
-      "digest": "sha256-KETVqPMNQCSN8faoNW7fHuSWc6rT/Jkp4+Lh31gQuQM=",
+      "digest": "sha256-pYvWThxhigEI7S1XeKyUkkN1KMZZPeRj/d5HV3ke+kQ=",
+      "file": "host-sequence-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/host-sequence-vector.schema.json"
+    },
+    {
+      "digest": "sha256-v2LFWwqpa0hS9XnYaVP9xC7Ohyw+Dl7ZG4e038+LqtI=",
       "file": "host-vector.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/host-vector.schema.json"
     },
@@ -129,40 +178,100 @@
       "id": "https://schemas.kumwe.org/studio/v1/pattern.schema.json"
     },
     {
-      "digest": "sha256-WWBFJmWz4p0F1PhOwup1rgBJuAkelWZz83SJX7mshGE=",
+      "digest": "sha256-UyyZAvE8JJcZqrKucPPK4oy2HPELR3q+zAl3pWPkWOU=",
       "file": "plugin-manifest.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/plugin-manifest.schema.json"
     },
     {
-      "digest": "sha256-wg6mVwubXmfpzfOZzlSamDJtyhdpD9/7vtqjb22SYB8=",
+      "digest": "sha256-7yQWc2+cZ+LoVmq2nZ5h4NsTO8tRjpODN7vIyJnbDKU=",
       "file": "preview-message.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/preview-message.schema.json"
     },
+    {
+      "digest": "sha256-h4au/6iI71X7lArbz5moSOxk29g+I+W/1Ewkeh7MqoI=",
+      "file": "preview-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/preview-vector.schema.json"
+    },
     {
       "digest": "sha256-QURE0s0zSfvGXEvy3meE4rQeofecsUVZksqQKfKv4ys=",
       "file": "provenance.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/provenance.schema.json"
     },
     {
-      "digest": "sha256-PKyCGI95WZ6Uojq9u5HvS2wwWU97+V+nmsY4l/Vc040=",
+      "digest": "sha256-cu3tmXzzoKCru9GNHj7QiUbprOf+zrcuiUhQZ3iTX1M=",
+      "file": "renderer-web-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/renderer-web-vector.schema.json"
+    },
+    {
+      "digest": "sha256-/DKHbScEb8525pjXQIhQipCSnS90y21f+2L8JMnRqJc=",
+      "file": "reusable-content-type.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/reusable-content-type.schema.json"
+    },
+    {
+      "digest": "sha256-74OcoS9iGzRnDOjo/opHhlXZdxMLcCUkw0Ol4ipzkws=",
       "file": "rich-text-projection.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/rich-text-projection.schema.json"
     },
     {
-      "digest": "sha256-PgFfnylfsJzq7B0wQq1gAxYA0r6gMx+xiKeT3NiDVqc=",
+      "digest": "sha256-r+wYEvy3tvMdQhmU0272K1cklAiYcEiD7nICWDdFFPs=",
       "file": "rich-text.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/rich-text.schema.json"
     },
     {
-      "digest": "sha256-yX+70kh/aPaBZiOlNon3R0B4W9ZWCnvOMKDF3ItxkqU=",
+      "digest": "sha256-200BYrY2bR/TvZGo852CHKtkxFn+7Yf2ULiVirg1R/o=",
+      "file": "schema-profile-vector.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/schema-profile-vector.schema.json"
+    },
+    {
+      "digest": "sha256-DbxBTu984mB1oo3O1kcDuqkxbmPJjtTXq65GptM8Xkw=",
       "file": "schema-profile.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/schema-profile.schema.json"
     },
     {
-      "digest": "sha256-FC0lGnAqTIdHLvlwbGyYGdXEK5mwtyhdyrCwt7WzVhY=",
+      "digest": "sha256-JyV/s49f+XgMI+zBVAmx9UgCXwK1qpMBWR7flnu9NW4=",
+      "file": "studio-browser-assets.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-browser-assets.schema.json"
+    },
+    {
+      "digest": "sha256-3jvAa7VGd6F7uAOR82AcTOSMGXWvgaMVmGsG1UzSXiI=",
+      "file": "studio-chart.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-chart.schema.json"
+    },
+    {
+      "digest": "sha256-LK81tgJb05u/pwRymTrccKbZiQHD7QXMYv14myilfGs=",
       "file": "studio-config.schema.json",
       "id": "https://schemas.kumwe.org/studio/v1/studio-config.schema.json"
     },
+    {
+      "digest": "sha256-T37m573XBWGK0mV7UAN/r+juuJ1Q5/cVen2B6iwPzw4=",
+      "file": "studio-deployment.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-deployment.schema.json"
+    },
+    {
+      "digest": "sha256-SAP1i3VfZS51FRsqnN2frFxE/UmI9xEUsSREUp/cA+E=",
+      "file": "studio-drawing.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-drawing.schema.json"
+    },
+    {
+      "digest": "sha256-6jp6QkIqqUrNSVAQJHOlK8BCb8vdAZF5QRZmyRUqfgM=",
+      "file": "studio-money.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-money.schema.json"
+    },
+    {
+      "digest": "sha256-+dyYyHfQcUz4n5BUNMmGODJ6J7n2ysm9/+rWpSrbODA=",
+      "file": "studio-presentation.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-presentation.schema.json"
+    },
+    {
+      "digest": "sha256-mQ98exmrEHcyy26sSav8dQ65BCdswHDh2zGvTkdlfB8=",
+      "file": "studio-release.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-release.schema.json"
+    },
+    {
+      "digest": "sha256-txf6OXjSyFvOcoepU01qNY2WWlTyDA3iquMVXrFC2tQ=",
+      "file": "studio-table.schema.json",
+      "id": "https://schemas.kumwe.org/studio/v1/studio-table.schema.json"
+    },
     {
       "digest": "sha256-xzhCb8J2nx+K6kBMciFj1glB4Q6jT8+KUdbUBsNM4h8=",
       "file": "theme.schema.json",

package/schemas/plugin-manifest.schema.json

@@ -52,6 +52,7 @@
         "properties": {
           "kind": {
             "enum": [
+              "authoring-target",
               "block",
               "command",
               "design-vocabulary",