@kumwe/studio-testkit 0.1.0-alpha.6 → 0.1.0-alpha.8

package/fixtures/host-operations.example.json

@@ -0,0 +1,270 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-operations",
+  "operations": [
+    {
+      "capability": "studio.operation/artifact.dependencies",
+      "expectsRevision": false,
+      "method": "dependencies",
+      "mutating": false,
+      "operation": "dependencies",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/dependencies"
+    },
+    {
+      "capability": "studio.operation/artifact.load",
+      "expectsRevision": false,
+      "method": "load",
+      "mutating": false,
+      "operation": "load",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/load"
+    },
+    {
+      "capability": "studio.operation/artifact.publish",
+      "expectsRevision": true,
+      "method": "publish",
+      "mutating": true,
+      "operation": "publish",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/publish"
+    },
+    {
+      "capability": "studio.operation/artifact.save",
+      "expectsRevision": true,
+      "method": "save",
+      "mutating": true,
+      "operation": "save",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/save"
+    },
+    {
+      "capability": "studio.operation/artifact.unpublish",
+      "expectsRevision": true,
+      "method": "unpublish",
+      "mutating": true,
+      "operation": "unpublish",
+      "port": "artifact",
+      "portCapability": "studio.port/artifact",
+      "required": true,
+      "route": "artifact/unpublish"
+    },
+    {
+      "capability": "studio.operation/localization.messages",
+      "expectsRevision": false,
+      "method": "messages",
+      "mutating": false,
+      "operation": "messages",
+      "port": "localization",
+      "portCapability": "studio.port/localization",
+      "required": false,
+      "route": "localization/messages"
+    },
+    {
+      "capability": "studio.operation/media.abort-upload",
+      "expectsRevision": false,
+      "method": "abortUpload",
+      "mutating": true,
+      "operation": "abort-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/abort-upload"
+    },
+    {
+      "capability": "studio.operation/media.authorize-upload",
+      "expectsRevision": false,
+      "method": "authorizeUpload",
+      "mutating": true,
+      "operation": "authorize-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/authorize-upload"
+    },
+    {
+      "capability": "studio.operation/media.complete-upload",
+      "expectsRevision": false,
+      "method": "completeUpload",
+      "mutating": true,
+      "operation": "complete-upload",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/complete-upload"
+    },
+    {
+      "capability": "studio.operation/media.get",
+      "expectsRevision": false,
+      "method": "get",
+      "mutating": false,
+      "operation": "get",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/get"
+    },
+    {
+      "capability": "studio.operation/media.import-external",
+      "expectsRevision": false,
+      "method": "importExternal",
+      "mutating": true,
+      "operation": "import-external",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/import-external"
+    },
+    {
+      "capability": "studio.operation/media.list",
+      "expectsRevision": false,
+      "method": "list",
+      "mutating": false,
+      "operation": "list",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/list"
+    },
+    {
+      "capability": "studio.operation/media.upload-status",
+      "expectsRevision": false,
+      "method": "uploadStatus",
+      "mutating": false,
+      "operation": "upload-status",
+      "port": "media",
+      "portCapability": "studio.port/media",
+      "required": false,
+      "route": "media/upload-status"
+    },
+    {
+      "capability": "studio.operation/model.get",
+      "expectsRevision": false,
+      "method": "get",
+      "mutating": false,
+      "operation": "get",
+      "port": "model",
+      "portCapability": "studio.port/model",
+      "required": false,
+      "route": "model/get"
+    },
+    {
+      "capability": "studio.operation/model.list",
+      "expectsRevision": false,
+      "method": "list",
+      "mutating": false,
+      "operation": "list",
+      "port": "model",
+      "portCapability": "studio.port/model",
+      "required": false,
+      "route": "model/list"
+    },
+    {
+      "capability": "studio.operation/permission.explain",
+      "expectsRevision": false,
+      "method": "explain",
+      "mutating": false,
+      "operation": "explain",
+      "port": "permission",
+      "portCapability": "studio.port/permission",
+      "required": false,
+      "route": "permission/explain"
+    },
+    {
+      "capability": "studio.operation/permission.refresh",
+      "expectsRevision": false,
+      "method": "refresh",
+      "mutating": false,
+      "operation": "refresh",
+      "port": "permission",
+      "portCapability": "studio.port/permission",
+      "required": false,
+      "route": "permission/refresh"
+    },
+    {
+      "capability": "studio.operation/preview.cancel",
+      "expectsRevision": false,
+      "method": "cancel",
+      "mutating": false,
+      "operation": "cancel",
+      "port": "preview",
+      "portCapability": "studio.port/preview",
+      "required": false,
+      "route": "preview/cancel"
+    },
+    {
+      "capability": "studio.operation/preview.render",
+      "expectsRevision": false,
+      "method": "render",
+      "mutating": false,
+      "operation": "render",
+      "port": "preview",
+      "portCapability": "studio.port/preview",
+      "required": false,
+      "route": "preview/render"
+    },
+    {
+      "capability": "studio.operation/recovery.discard",
+      "expectsRevision": false,
+      "method": "discard",
+      "mutating": true,
+      "operation": "discard",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/discard"
+    },
+    {
+      "capability": "studio.operation/recovery.load",
+      "expectsRevision": false,
+      "method": "load",
+      "mutating": false,
+      "operation": "load",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/load"
+    },
+    {
+      "capability": "studio.operation/recovery.store",
+      "expectsRevision": false,
+      "method": "store",
+      "mutating": true,
+      "operation": "store",
+      "port": "recovery",
+      "portCapability": "studio.port/recovery",
+      "required": false,
+      "route": "recovery/store"
+    },
+    {
+      "capability": "studio.operation/resource.search",
+      "expectsRevision": false,
+      "method": "search",
+      "mutating": false,
+      "operation": "search",
+      "port": "resource",
+      "portCapability": "studio.port/resource",
+      "required": false,
+      "route": "resource/search"
+    },
+    {
+      "capability": "studio.operation/telemetry.emit",
+      "expectsRevision": false,
+      "method": "emit",
+      "mutating": true,
+      "operation": "emit",
+      "port": "telemetry",
+      "portCapability": "studio.port/telemetry",
+      "required": false,
+      "route": "telemetry/emit"
+    }
+  ]
+}

package/fixtures/inspector.example.json

@@ -0,0 +1,17 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "inspector",
+  "id": "org.example.catalog/price-inspector",
+  "version": "1.0.0",
+  "owner": {
+    "id": "org.example/catalog",
+    "version": "1.0.0"
+  },
+  "label": {
+    "key": "org.example.catalog/price-inspector",
+    "defaultMessage": "Price inspector"
+  },
+  "blockTypes": ["org.example.catalog/price"],
+  "placement": "augment",
+  "requiredCapability": "studio.capability/custom-inspectors"
+}

package/fixtures/media-upload-grant.example.json

@@ -0,0 +1,14 @@
+{
+  "expiresAt": "2026-08-18T23:30:00Z",
+  "headers": {
+    "X-Upload-Session": "uploads-7f2c"
+  },
+  "method": "PUT",
+  "plan": {
+    "chunkBytes": 5242880,
+    "maximumBytes": 52428800,
+    "resumable": true
+  },
+  "uploadId": "uploads/7f2c",
+  "url": "https://media.example.org/uploads/7f2c"
+}

package/fixtures/preview.render.example.json

@@ -9,6 +9,7 @@
     "artifactId": "org.example.blueprints/product-card",
     "draftDigest": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
     "draftRevision": "product-card-r5-local-12",
+    "requestId": "renders/product-card-14",
     "viewport": "expanded"
   }
 }

package/fixtures/studio-config.example.json

@@ -1,6 +1,6 @@
 {
   "contractVersion": "0.1-draft",
-  "protocolVersion": "0.1.0-draft.1",
+  "protocolVersion": "0.1.0-draft.2",
   "sessionId": "session-018f",
   "sessionGeneration": "session-generation-1",
   "mode": "content",
@@ -89,16 +89,16 @@
     "contractVersion": "0.1-draft",
     "kind": "host-capabilities",
     "host": {
-      "id": "org.kumwe/cms",
+      "id": "org.kumwe/app",
       "version": "3.0.0-alpha.1",
       "generation": "runtime-generation-42"
     },
-    "protocolVersions": ["0.1.0-draft.1"],
+    "protocolVersions": ["0.1.0-draft.2"],
     "ports": [
       {
         "id": "studio.port/artifact",
         "version": "1.0.0",
-        "operations": ["studio.operation/load", "studio.operation/save"]
+        "operations": ["studio.operation/artifact.load", "studio.operation/artifact.save"]
       }
     ],
     "capabilities": []

package/invalid/host-capabilities.invalid-protocol-version.json

@@ -5,7 +5,7 @@
     "contractVersion": "0.1-draft",
     "kind": "host-capabilities",
     "host": {
-      "id": "org.kumwe/cms",
+      "id": "org.kumwe/app",
       "version": "3.0.0-alpha.1",
       "generation": "runtime-generation-42"
     },

package/invalid/host-sequence.pending-expectation.json

@@ -0,0 +1,52 @@
+{
+  "schema": "host-sequence-vector.schema.json",
+  "description": "A pending invocation cannot declare a settled outcome before an explicit settle step.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "host-sequence-vector",
+    "id": "vector.host-sequence.invalid.pending-expectation",
+    "description": "Invalid pending sequence step.",
+    "profile": "studio.profile/host-baseline-v2",
+    "assertions": ["in-flight-preview-cancellation"],
+    "idempotencyPolicy": {
+      "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+      "argumentCanonicalization": "canonical-json",
+      "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+      "absentOptionalFields": "omit",
+      "numberNormalization": "canonical-json",
+      "excludedContextFields": ["requestId", "traceContext"]
+    },
+    "given": { "artifacts": [], "permissions": [], "sessionGeneration": "session-r1" },
+    "steps": [
+      {
+        "action": "invoke",
+        "id": "render-pending",
+        "port": "preview",
+        "operation": "render",
+        "context": {
+          "operationId": "studio.operation/preview.render",
+          "protocolVersion": "0.1.0-draft.2",
+          "requestId": "requests/preview-render",
+          "resourceContextKey": "contexts/vector",
+          "sessionGeneration": "session-r1"
+        },
+        "argument": {
+          "artifactId": "vector.blueprint",
+          "draftDigest": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+          "draftRevision": "vector-blueprint-r1",
+          "requestId": "renders/pending-invalid-1",
+          "viewport": "desktop"
+        },
+        "completion": "pending",
+        "expect": { "outcome": "result", "value": "rendered" }
+      },
+      {
+        "action": "settle",
+        "id": "render-settled",
+        "invocation": "render-pending",
+        "expect": { "outcome": "error", "category": "cancelled", "retryable": false }
+      }
+    ],
+    "expectFinal": { "pendingPreviewRenders": 0, "previewDeliveries": [] }
+  }
+}

package/invalid/host-sequence.preview-render-missing-request-id.json

@@ -0,0 +1,50 @@
+{
+  "schema": "host-sequence-vector.schema.json",
+  "description": "A preview render invocation must carry the complete draft.2 render identity, including its session-unique request identifier.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "host-sequence-vector",
+    "id": "vector.host-sequence.invalid.preview-render-missing-request-id",
+    "description": "Invalid preview render identity.",
+    "profile": "studio.profile/host-baseline-v2",
+    "assertions": ["cross-context-cancellation-isolation"],
+    "idempotencyPolicy": {
+      "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+      "argumentCanonicalization": "canonical-json",
+      "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+      "absentOptionalFields": "omit",
+      "numberNormalization": "canonical-json",
+      "excludedContextFields": ["requestId", "traceContext"]
+    },
+    "given": { "artifacts": [], "permissions": [], "sessionGeneration": "session-r1" },
+    "steps": [
+      {
+        "action": "invoke",
+        "id": "render-missing-request-id",
+        "port": "preview",
+        "operation": "render",
+        "context": {
+          "operationId": "studio.operation/preview.render",
+          "protocolVersion": "0.1.0-draft.2",
+          "requestId": "requests/preview-render",
+          "resourceContextKey": "contexts/vector",
+          "sessionGeneration": "session-r1"
+        },
+        "argument": {
+          "artifactId": "vector.blueprint",
+          "draftDigest": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+          "draftRevision": "vector-blueprint-r1",
+          "viewport": "desktop"
+        },
+        "completion": "pending"
+      },
+      {
+        "action": "settle",
+        "id": "render-settled",
+        "invocation": "render-missing-request-id",
+        "expect": { "outcome": "error", "category": "invalid-request", "retryable": false }
+      }
+    ],
+    "expectFinal": { "pendingPreviewRenders": 0, "previewDeliveries": [] }
+  }
+}

package/invalid/inspector.empty-block-types.json

@@ -0,0 +1,20 @@
+{
+  "schema": "inspector.schema.json",
+  "description": "An inspector declares the block types it applies to; an empty list would silently apply to none.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "inspector",
+    "id": "org.example.catalog/price-inspector",
+    "version": "1.0.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.0.0"
+    },
+    "label": {
+      "key": "org.example.catalog/price-inspector",
+      "defaultMessage": "Price inspector"
+    },
+    "blockTypes": [],
+    "placement": "augment"
+  }
+}

package/invalid/media-upload-grant.insecure-url.json

@@ -0,0 +1,14 @@
+{
+  "schema": "media-upload-grant.schema.json",
+  "description": "An upload destination is always an https URL the host controls.",
+  "value": {
+    "expiresAt": "2026-08-18T23:30:00Z",
+    "method": "PUT",
+    "plan": {
+      "maximumBytes": 52428800,
+      "resumable": false
+    },
+    "uploadId": "uploads/7f2c",
+    "url": "http://media.example.org/uploads/7f2c"
+  }
+}

package/invalid/preview-message.activated-unknown-interaction.json

@@ -0,0 +1,16 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Activation reports the closed interaction vocabulary, never an arbitrary input event.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/activated",
+    "payload": {
+      "interaction": "hover",
+      "marker": "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+    }
+  }
+}

package/invalid/preview-message.duplicate-marker.json

@@ -0,0 +1,24 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A rendered marker inventory contains each canonical marker exactly once.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": [
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0",
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+      ],
+      "markerMap": {
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0": "node-1"
+      },
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.invalid-digest.json

@@ -12,6 +12,7 @@
       "artifactId": "org.example.blueprints/product-card",
       "draftDigest": "not-a-digest",
       "draftRevision": "product-card-r5-local-12",
+      "requestId": "renders/product-card-14",
       "viewport": "expanded"
     }
   }

package/invalid/preview-message.invalid-marker-grammar.json

@@ -0,0 +1,19 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A preview marker binds one canonical draft digest to a bounded zero-based preorder ordinal.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": ["markers/m1"],
+      "markerMap": { "markers/m1": "node-1" },
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.missing-marker-map.json

@@ -0,0 +1,20 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A rendered response must carry an exact marker-to-node map for its complete marker inventory.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/rendered",
+    "payload": {
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "markers": [
+        "studio.preview/node/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/0"
+      ],
+      "requestId": "renders/1",
+      "diagnostics": []
+    }
+  }
+}

package/invalid/preview-message.missing-render-request-id.json

@@ -0,0 +1,18 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Every render attempt has a session-unique request identifier for exact callback correlation.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "studio.preview/render",
+    "payload": {
+      "artifactId": "blueprints/example",
+      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "draftRevision": "blueprint-r1",
+      "viewport": "expanded"
+    }
+  }
+}

package/invalid/preview-message.unknown-type.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "The draft.2 preview vocabulary is closed; unknown message types require a negotiated protocol revision.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 4,
+    "type": "org.example.preview/custom",
+    "payload": {}
+  }
+}

package/invalid/preview-message.viewport-height-too-small.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Explicit preview viewport width and height are each bounded to at least 240 CSS pixels.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": { "height": 239 }
+  }
+}

package/invalid/preview-message.viewport-role-and-size.json

@@ -0,0 +1,16 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "A viewport instruction carries a semantic role or explicit dimensions, never both.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": {
+      "viewport": "compact",
+      "width": 1280
+    }
+  }
+}

package/invalid/preview-message.viewport-unsafe-role.json

@@ -0,0 +1,13 @@
+{
+  "schema": "preview-message.schema.json",
+  "description": "Semantic viewport roles use the safe local-name grammar.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "preview-message",
+    "channelId": "preview-channel-1",
+    "sessionGeneration": "session-r1",
+    "sequence": 3,
+    "type": "studio.preview/viewport",
+    "payload": { "viewport": "constructor" }
+  }
+}