@kumwe/studio-testkit 0.1.0-alpha.10

package/vectors/host/model.get.stored.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.model.get.stored",
+  "description": "Getting an authorized model resolves one exact ID, semantic version, and immutable revision through the read-only model port.",
+  "profile": "studio.profile/host-baseline",
+  "port": "model",
+  "operation": "get",
+  "given": {
+    "artifacts": [
+      {
+        "id": "studio.test/article-model",
+        "kind": "content-model",
+        "revision": "model-r1"
+      }
+    ],
+    "permissions": [],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/model.get",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/model-get-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "studio.test/article-model",
+    "version": "1.0.0",
+    "revision": "model-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "revision": "model-r1",
+    "value": "content-model"
+  }
+}

package/vectors/host/model.list.authorized.json

@@ -0,0 +1,31 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.model.list.authorized",
+  "description": "Listing models returns only the authorized content-model projections in deterministic coordinate order.",
+  "profile": "studio.profile/host-baseline",
+  "port": "model",
+  "operation": "list",
+  "given": {
+    "artifacts": [
+      {
+        "id": "studio.test/article-model",
+        "kind": "content-model",
+        "revision": "model-r1"
+      }
+    ],
+    "permissions": [],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/model.list",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/model-list-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "content-models"
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.permission.explain.withheld",
+  "description": "An operation the acting identity does not hold is explained as disallowed with a safe reason, never by silently succeeding.",
+  "profile": "studio.profile/host-baseline",
+  "port": "permission",
+  "operation": "explain",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/permission.explain",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "operation": "studio.permission/publish"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "permission-explanation"
+  }
+}

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

@@ -0,0 +1,31 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.permission.refresh.snapshot",
+  "description": "Refreshing authority answers with the held permissions and the live session generation.",
+  "profile": "studio.profile/host-baseline",
+  "port": "permission",
+  "operation": "refresh",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/permission.refresh",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "permission-snapshot"
+  }
+}

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

@@ -0,0 +1,31 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.recovery.load.absent",
+  "description": "A recovery envelope that was never stored resolves empty for the requesting context.",
+  "profile": "studio.profile/host-baseline",
+  "port": "recovery",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/recovery.load",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "null"
+  }
+}

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

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.telemetry.emit.accepted",
+  "description": "A telemetry event carrying only primitive attributes is accepted.",
+  "profile": "studio.profile/host-baseline",
+  "port": "telemetry",
+  "operation": "emit",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "attributes": {
+      "surface": "canvas"
+    },
+    "name": "studio.telemetry/vector"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "null"
+  }
+}

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

@@ -0,0 +1,40 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.telemetry.emit.non-primitive",
+  "description": "A telemetry attribute that is not a JSON primitive is refused, keeping the cardinality discipline enforceable.",
+  "profile": "studio.profile/host-baseline",
+  "port": "telemetry",
+  "operation": "emit",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "attributes": {
+      "surface": {
+        "nested": true
+      }
+    },
+    "name": "studio.telemetry/vector"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}

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": []
+  }
+}