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

package/vectors/host/media.complete-upload.unknown.error.json

@@ -19,7 +19,7 @@
   },
   "context": {
     "operationId": "studio.operation/media.complete-upload",
-    "protocolVersion": "0.1.0-draft.1",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/media.get.unknown.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/media.get",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/media.import-external.private-host.error.json

@@ -19,7 +19,7 @@
   },
   "context": {
     "operationId": "studio.operation/media.import-external",
-    "protocolVersion": "0.1.0-draft.1",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/media.list.cursor.error.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/media.list",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/media.list.limit.error.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/media.list",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/media.upload-status.unknown.error.json

@@ -19,7 +19,7 @@
   },
   "context": {
     "operationId": "studio.operation/media.upload-status",
-    "protocolVersion": "0.1.0-draft.1",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/permission.explain.withheld.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/permission.explain",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/permission.refresh.snapshot.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/permission.refresh",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/recovery.load.absent.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/recovery.load",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/telemetry.emit.accepted.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host/telemetry.emit.non-primitive.error.json

@@ -18,8 +18,8 @@
     "sessionGeneration": "session-r1"
   },
   "context": {
-    "operationId": "studio.host/operation",
-    "protocolVersion": "0.1.0-draft.1",
+    "operationId": "studio.operation/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
     "requestId": "requests/vector-1",
     "resourceContextKey": "contexts/vector",
     "sessionGeneration": "session-r1"

package/vectors/host-sequence/artifact.publish.changed-intent.sequence.json

@@ -0,0 +1,75 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.artifact.publish.changed-intent",
+  "description": "A publication key accepted for one artifact reference refuses a changed argument before concurrency evaluation, while preserving the exact seeded kind, revision and session generation.",
+  "profile": "studio.profile/host-baseline-v2",
+  "assertions": ["idempotency-changed-argument-refusal"],
+  "idempotencyPolicy": {
+    "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+    "argumentCanonicalization": "canonical-json",
+    "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+    "absentOptionalFields": "omit",
+    "numberNormalization": "canonical-json",
+    "excludedContextFields": ["requestId", "traceContext"]
+  },
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.model",
+        "kind": "content-model",
+        "revision": "upstream-content-r41",
+        "status": "draft"
+      }
+    ],
+    "permissions": ["studio.permission/publish"],
+    "sessionGeneration": "session-live-r41"
+  },
+  "steps": [
+    {
+      "action": "invoke",
+      "id": "publish-first",
+      "port": "artifact",
+      "operation": "publish",
+      "context": {
+        "operationId": "studio.operation/artifact.publish",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/publish-first",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-live-r41",
+        "expectedRevision": "upstream-content-r41",
+        "idempotencyKey": "idempotency/publish-model"
+      },
+      "argument": { "id": "vector.model", "version": "1.0.0" },
+      "completion": "settled",
+      "expect": {
+        "outcome": "result",
+        "revisionAdvancesFrom": "upstream-content-r41",
+        "value": "null"
+      }
+    },
+    {
+      "action": "invoke",
+      "id": "publish-changed-intent",
+      "port": "artifact",
+      "operation": "publish",
+      "context": {
+        "operationId": "studio.operation/artifact.publish",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/publish-changed",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-live-r41",
+        "expectedRevision": "upstream-content-r41",
+        "idempotencyKey": "idempotency/publish-model"
+      },
+      "argument": { "id": "vector.model", "version": "2.0.0" },
+      "completion": "settled",
+      "expect": { "outcome": "error", "category": "invalid-request", "retryable": false }
+    }
+  ],
+  "expectFinal": {
+    "artifacts": [{ "id": "vector.model", "status": "published", "revisionFrom": "publish-first" }],
+    "pendingPreviewRenders": 0,
+    "previewDeliveries": []
+  }
+}

package/vectors/host-sequence/artifact.publish.idempotent-replay.sequence.json

@@ -0,0 +1,111 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.artifact.publish.idempotent-replay",
+  "description": "In-flight and completed retries of an accepted publication coalesce on one result, do not consume another rate-limit unit, and ignore per-attempt request and trace correlation.",
+  "profile": "studio.profile/host-baseline-v2",
+  "assertions": ["idempotent-in-flight-coalescing", "idempotent-completed-replay"],
+  "idempotencyPolicy": {
+    "scopeFields": ["idempotencyKey", "operationId", "resourceContextKey", "sessionGeneration"],
+    "argumentCanonicalization": "canonical-json",
+    "intentContextFields": ["expectedRevision", "locale", "protocolVersion"],
+    "absentOptionalFields": "omit",
+    "numberNormalization": "canonical-json",
+    "excludedContextFields": ["requestId", "traceContext"]
+  },
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1",
+        "status": "draft"
+      }
+    ],
+    "permissions": ["studio.permission/publish"],
+    "sessionGeneration": "session-r1",
+    "rateLimits": [
+      {
+        "operationId": "studio.operation/artifact.publish",
+        "maximumRequests": 1,
+        "windowMilliseconds": 60000,
+        "retryAfterMilliseconds": 60000
+      }
+    ]
+  },
+  "steps": [
+    {
+      "action": "invoke",
+      "id": "publish-first",
+      "port": "artifact",
+      "operation": "publish",
+      "context": {
+        "operationId": "studio.operation/artifact.publish",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/publish-first",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-r1",
+        "expectedRevision": "vector.blueprint-r1",
+        "idempotencyKey": "idempotency/publish-vector",
+        "traceContext": { "traceparent": "trace-first" }
+      },
+      "argument": { "id": "vector.blueprint", "version": "1.0.0" },
+      "completion": "pending"
+    },
+    {
+      "action": "invoke",
+      "id": "publish-coalesced",
+      "port": "artifact",
+      "operation": "publish",
+      "context": {
+        "operationId": "studio.operation/artifact.publish",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/publish-coalesced",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-r1",
+        "expectedRevision": "vector.blueprint-r1",
+        "idempotencyKey": "idempotency/publish-vector",
+        "traceContext": { "traceparent": "trace-coalesced" }
+      },
+      "argument": { "id": "vector.blueprint", "version": "1.0.0" },
+      "completion": "settled",
+      "expect": {
+        "outcome": "result",
+        "revisionAdvancesFrom": "vector.blueprint-r1",
+        "value": "null"
+      }
+    },
+    {
+      "action": "settle",
+      "id": "publish-first-settled",
+      "invocation": "publish-first",
+      "expect": { "outcome": "result", "sameAs": "publish-coalesced", "value": "null" }
+    },
+    {
+      "action": "invoke",
+      "id": "publish-completed-replay",
+      "port": "artifact",
+      "operation": "publish",
+      "context": {
+        "operationId": "studio.operation/artifact.publish",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/publish-completed",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-r1",
+        "expectedRevision": "vector.blueprint-r1",
+        "idempotencyKey": "idempotency/publish-vector",
+        "traceContext": { "traceparent": "trace-completed" }
+      },
+      "argument": { "id": "vector.blueprint", "version": "1.0.0" },
+      "completion": "settled",
+      "expect": { "outcome": "result", "sameAs": "publish-first", "value": "null" }
+    }
+  ],
+  "expectFinal": {
+    "artifacts": [
+      { "id": "vector.blueprint", "status": "published", "revisionFrom": "publish-first" }
+    ],
+    "pendingPreviewRenders": 0,
+    "previewDeliveries": []
+  }
+}

package/vectors/host-sequence/preview.cancel.cross-context.sequence.json

@@ -0,0 +1,78 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.preview.cancel.cross-context",
+  "description": "Cancellation in another resource context cannot cancel an in-flight render with the same draft digest; the original render completes and is delivered once.",
+  "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-context-a",
+      "port": "preview",
+      "operation": "render",
+      "context": {
+        "operationId": "studio.operation/preview.render",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/render-context-a",
+        "resourceContextKey": "contexts/preview-a",
+        "sessionGeneration": "session-r1"
+      },
+      "argument": {
+        "artifactId": "vector.blueprint",
+        "draftDigest": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+        "draftRevision": "vector-blueprint-r1",
+        "requestId": "renders/context-a-1",
+        "viewport": "desktop"
+      },
+      "completion": "pending"
+    },
+    {
+      "action": "invoke",
+      "id": "cancel-context-b",
+      "port": "preview",
+      "operation": "cancel",
+      "context": {
+        "operationId": "studio.operation/preview.cancel",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/cancel-context-b",
+        "resourceContextKey": "contexts/preview-b",
+        "sessionGeneration": "session-r1"
+      },
+      "argument": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "completion": "settled",
+      "expect": { "outcome": "result", "value": "null" }
+    },
+    {
+      "action": "release-preview-render",
+      "id": "release-context-a",
+      "invocation": "render-context-a",
+      "value": {
+        "draftDigest": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+        "markers": [],
+        "markerMap": {},
+        "diagnostics": [],
+        "requestId": "renders/context-a-1"
+      }
+    },
+    {
+      "action": "settle",
+      "id": "render-context-a-settled",
+      "invocation": "render-context-a",
+      "expect": { "outcome": "result", "value": "rendered" }
+    }
+  ],
+  "expectFinal": {
+    "pendingPreviewRenders": 0,
+    "previewDeliveries": ["cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"]
+  }
+}

package/vectors/host-sequence/preview.render.cancelled.sequence.json

@@ -0,0 +1,75 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.preview.render.cancelled",
+  "description": "A renderer completion released after cancellation cannot escape: cancel returns null, render settles cancelled, and the late result is not delivered.",
+  "profile": "studio.profile/host-baseline-v2",
+  "assertions": ["in-flight-preview-cancellation", "late-preview-result-discard"],
+  "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/cancelled-1",
+        "viewport": "desktop"
+      },
+      "completion": "pending"
+    },
+    {
+      "action": "invoke",
+      "id": "cancel-render",
+      "port": "preview",
+      "operation": "cancel",
+      "context": {
+        "operationId": "studio.operation/preview.cancel",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/preview-cancel",
+        "resourceContextKey": "contexts/vector",
+        "sessionGeneration": "session-r1"
+      },
+      "argument": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+      "completion": "settled",
+      "expect": { "outcome": "result", "value": "null" }
+    },
+    {
+      "action": "release-preview-render",
+      "id": "release-late-render",
+      "invocation": "render-pending",
+      "value": {
+        "draftDigest": "b03cc45a784d7cd4d2836e24694d42f9c8e2ee3dde3ceca79b0a147436db47c6",
+        "markers": [],
+        "markerMap": {},
+        "diagnostics": [],
+        "requestId": "renders/cancelled-1"
+      }
+    },
+    {
+      "action": "settle",
+      "id": "render-cancelled",
+      "invocation": "render-pending",
+      "expect": { "outcome": "error", "category": "cancelled", "retryable": false }
+    }
+  ],
+  "expectFinal": { "pendingPreviewRenders": 0, "previewDeliveries": [] }
+}

package/vectors/host-sequence/recovery.store.canonical-number.sequence.json

@@ -0,0 +1,72 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.recovery.store.canonical-number",
+  "description": "Canonical JSON normalizes negative zero to zero, so requests that differ only by that numeric spelling replay one accepted recovery write.",
+  "profile": "studio.profile/host-baseline-v2",
+  "assertions": ["canonical-number-equivalence", "idempotent-completed-replay"],
+  "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",
+    "rateLimits": [
+      {
+        "operationId": "studio.operation/recovery.store",
+        "maximumRequests": 1,
+        "windowMilliseconds": 60000,
+        "retryAfterMilliseconds": 60000
+      }
+    ]
+  },
+  "steps": [
+    {
+      "action": "invoke",
+      "id": "store-negative-zero",
+      "port": "recovery",
+      "operation": "store",
+      "context": {
+        "operationId": "studio.operation/recovery.store",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/store-negative-zero",
+        "resourceContextKey": "contexts/canonical-number",
+        "sessionGeneration": "session-r1",
+        "idempotencyKey": "idempotency/canonical-number",
+        "traceContext": { "traceparent": "trace-negative-zero" }
+      },
+      "argument": { "value": -0 },
+      "completion": "settled",
+      "expect": { "outcome": "result", "value": "null" }
+    },
+    {
+      "action": "invoke",
+      "id": "store-positive-zero-replay",
+      "port": "recovery",
+      "operation": "store",
+      "context": {
+        "operationId": "studio.operation/recovery.store",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/store-positive-zero",
+        "resourceContextKey": "contexts/canonical-number",
+        "sessionGeneration": "session-r1",
+        "idempotencyKey": "idempotency/canonical-number",
+        "traceContext": { "traceparent": "trace-positive-zero" }
+      },
+      "argument": { "value": 0 },
+      "completion": "settled",
+      "expect": { "outcome": "result", "sameAs": "store-negative-zero", "value": "null" }
+    }
+  ],
+  "expectFinal": {
+    "recovery": [{ "resourceContextKey": "contexts/canonical-number", "value": { "value": 0 } }],
+    "pendingPreviewRenders": 0,
+    "previewDeliveries": []
+  }
+}

package/vectors/host-sequence/recovery.store.changed-context.sequence.json

@@ -0,0 +1,61 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-sequence-vector",
+  "id": "vector.host-sequence.recovery.store.changed-context",
+  "description": "Adding an optional semantic context field changes the canonical intent: an accepted key with absent locale refuses the same argument when locale becomes present.",
+  "profile": "studio.profile/host-baseline-v2",
+  "assertions": ["idempotency-changed-context-refusal"],
+  "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": "store-without-locale",
+      "port": "recovery",
+      "operation": "store",
+      "context": {
+        "operationId": "studio.operation/recovery.store",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/store-without-locale",
+        "resourceContextKey": "contexts/context-intent",
+        "sessionGeneration": "session-r1",
+        "idempotencyKey": "idempotency/context-intent"
+      },
+      "argument": { "draft": "retained" },
+      "completion": "settled",
+      "expect": { "outcome": "result", "value": "null" }
+    },
+    {
+      "action": "invoke",
+      "id": "store-with-locale",
+      "port": "recovery",
+      "operation": "store",
+      "context": {
+        "operationId": "studio.operation/recovery.store",
+        "protocolVersion": "0.1.0-draft.2",
+        "requestId": "requests/store-with-locale",
+        "resourceContextKey": "contexts/context-intent",
+        "sessionGeneration": "session-r1",
+        "idempotencyKey": "idempotency/context-intent",
+        "locale": "en"
+      },
+      "argument": { "draft": "retained" },
+      "completion": "settled",
+      "expect": { "outcome": "error", "category": "invalid-request", "retryable": false }
+    }
+  ],
+  "expectFinal": {
+    "recovery": [
+      { "resourceContextKey": "contexts/context-intent", "value": { "draft": "retained" } }
+    ],
+    "pendingPreviewRenders": 0,
+    "previewDeliveries": []
+  }
+}