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

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/studio-config.example.json

@@ -98,7 +98,7 @@
       {
         "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/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": "node-1"
+    }
+  }
+}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kumwe/studio-testkit",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kumwe/studio.git",
@@ -13,11 +13,12 @@
   "sideEffects": false,
   "files": [
     "LICENSE",
+    "README.md",
     "conformance",
+    "corpus-manifest.json",
     "dist",
     "fixtures",
     "invalid",
-    "README.md",
     "vectors"
   ],
   "exports": {
@@ -26,6 +27,7 @@
       "import": "./dist/index.js"
     },
     "./conformance/*": "./conformance/*",
+    "./corpus-manifest.json": "./corpus-manifest.json",
     "./fixtures/*": "./fixtures/*",
     "./invalid/*": "./invalid/*",
     "./vectors/*": "./vectors/*"
@@ -34,8 +36,8 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@kumwe/studio-core": "0.1.0-alpha.6",
-    "@kumwe/studio-protocol": "0.1.0-alpha.4"
+    "@kumwe/studio-core": "0.1.0-alpha.7",
+    "@kumwe/studio-protocol": "0.1.0-alpha.5"
   },
   "publishConfig": {
     "access": "public",

package/vectors/canonical/array-order.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.array-order",
+  "description": "Arrays keep semantic order; only object members are sorted.",
+  "value": {
+    "items": ["c", "a", "b"]
+  },
+  "expect": {
+    "canonical": "{\"items\":[\"c\",\"a\",\"b\"]}",
+    "digest": "sha256-Skzt0qRLwO/5TqmcmghEQQEADtJ5ASbjphmWAaasB7U="
+  }
+}

package/vectors/canonical/control-characters.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.control-characters",
+  "description": "Control characters without a short form are escaped as four hex digits.",
+  "value": {
+    "value": "bell\u0007 unit\u001f"
+  },
+  "expect": {
+    "canonical": "{\"value\":\"bell\\u0007 unit\\u001f\"}",
+    "digest": "sha256-V332co6E4LRxsTuTQ5OLD98jGjDBZAAmzZDCJOFGDNA="
+  }
+}

package/vectors/canonical/depth-exceeded.json

@@ -0,0 +1,21 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.depth-exceeded",
+  "description": "Nesting deeper than the declared bound is refused rather than truncated.",
+  "value": {
+    "a": {
+      "a": {
+        "a": {
+          "a": {
+            "a": 1
+          }
+        }
+      }
+    }
+  },
+  "maximumDepth": 3,
+  "expect": {
+    "rejected": "depth-exceeded"
+  }
+}

package/vectors/canonical/empty-containers.json

@@ -0,0 +1,14 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.empty-containers",
+  "description": "Empty objects and arrays serialize without padding.",
+  "value": {
+    "array": [],
+    "object": {}
+  },
+  "expect": {
+    "canonical": "{\"array\":[],\"object\":{}}",
+    "digest": "sha256-E7OK6rLhiixi3ilF25YAcggBtIPkGTb1oVTb2nJhvnA="
+  }
+}

package/vectors/canonical/forbidden-member.json

@@ -0,0 +1,14 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.forbidden-member",
+  "description": "A forbidden member name is refused rather than silently dropped.",
+  "value": {
+    "__proto__": {
+      "polluted": true
+    }
+  },
+  "expect": {
+    "rejected": "forbidden-member"
+  }
+}

package/vectors/canonical/member-order.json

@@ -0,0 +1,16 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.member-order",
+  "description": "Object members sort by Unicode code unit, not by locale or insertion order.",
+  "value": {
+    "b": 1,
+    "A": 2,
+    "a": 3,
+    "Z": 4
+  },
+  "expect": {
+    "canonical": "{\"A\":2,\"Z\":4,\"a\":3,\"b\":1}",
+    "digest": "sha256-Vn19opLXri8fGzPIdqbQbXdepLMLLlGlhBb5yr19cyk="
+  }
+}

package/vectors/canonical/negative-zero.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.negative-zero",
+  "description": "Negative zero canonicalizes to zero so two equal values never differ in bytes.",
+  "value": {
+    "value": -0.0
+  },
+  "expect": {
+    "canonical": "{\"value\":0}",
+    "digest": "sha256-I9eyhr1ClGC5KiocIbavw0EQRGxQNMFzY/2jY6oKfF0="
+  }
+}

package/vectors/canonical/nested-order.json

@@ -0,0 +1,19 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.nested-order",
+  "description": "Sorting is recursive: every nested object is ordered the same way.",
+  "value": {
+    "outer": {
+      "z": 1,
+      "a": {
+        "y": 2,
+        "b": 3
+      }
+    }
+  },
+  "expect": {
+    "canonical": "{\"outer\":{\"a\":{\"b\":3,\"y\":2},\"z\":1}}",
+    "digest": "sha256-3TQ80V/GRN0uwwkENcctjI199+5MjvAWVuMxlJcDZRw="
+  }
+}

package/vectors/canonical/non-ascii.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.non-ascii",
+  "description": "Non-ASCII text is emitted as UTF-8, never as escape sequences.",
+  "value": {
+    "value": "héllo — 日本語"
+  },
+  "expect": {
+    "canonical": "{\"value\":\"héllo — 日本語\"}",
+    "digest": "sha256-lrSVhIWiYBcsHDXMZ3FTt4QcB2pNvqKW8TRX2F803+Y="
+  }
+}

package/vectors/canonical/numbers.json

@@ -0,0 +1,16 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.numbers",
+  "description": "Integers and decimals use the deterministic number grammar.",
+  "value": {
+    "decimal": 1.5,
+    "integer": 42,
+    "large": 9007199254740991,
+    "negative": -7
+  },
+  "expect": {
+    "canonical": "{\"decimal\":1.5,\"integer\":42,\"large\":9007199254740991,\"negative\":-7}",
+    "digest": "sha256-HI1BWhgmbgXvatESL+t+Y1QwYSfvAT4DOaYjU2fmdbQ="
+  }
+}

package/vectors/canonical/string-escapes.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.string-escapes",
+  "description": "Only the characters ECMA-404 requires are escaped, using the short forms where they exist.",
+  "value": {
+    "value": "quote\" backslash\\ newline\n tab\t"
+  },
+  "expect": {
+    "canonical": "{\"value\":\"quote\\\" backslash\\\\ newline\\n tab\\t\"}",
+    "digest": "sha256-cci0wehH9sStfAleZcirUIOhCgpJKS8jPtKs34gE+ic="
+  }
+}

package/vectors/canonical/surrogate-pair.json

@@ -0,0 +1,13 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "canonical-vector",
+  "id": "vector.canonical-vector.surrogate-pair",
+  "description": "An astral character stays one code point in the UTF-8 bytes.",
+  "value": {
+    "value": "😀"
+  },
+  "expect": {
+    "canonical": "{\"value\":\"😀\"}",
+    "digest": "sha256-L8ufbEEor6c96MSNyg/HwfpSDn3KX29eewMH1oMoIMk="
+  }
+}

package/vectors/host/artifact.dependencies.result.json

@@ -0,0 +1,35 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.dependencies",
+  "description": "Dependency inspection answers with the authorized reference list.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "dependencies",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "artifact-references"
+  }
+}