browser/openspec/changes/fix-scum-run-distribution-smoke/specs/scum-run-distribution-smoke/spec.md

ADDED Requirements

Requirement: SCUM local debug run distribution proof

The local debug smoke fixture SHALL register the first-party SCUM plugin with enough safe platform metadata for SCUM run distribution APIs to be exercised.

Scenario: SCUM run generation is available

• WHEN local debug smoke registers game.scum and creates scum-alpha
• THEN GET /api/v1/server-instances/scum-alpha/runtime/actions MUST report generate-run as available

Scenario: SCUM run package is generated

• WHEN local debug smoke calls POST /api/v1/server-instances/scum-alpha/run/generate for Windows AMD64
• THEN the response MUST include an artifact ID and checksum without exposing raw keys, host paths, direct sockets, bearer credentials, or plugin-owned transport details

Scenario: SCUM run package generation is idempotent after a partial artifact write

• WHEN POST /api/v1/server-instances/scum-alpha/run/generate is retried with the same idempotency key after the deterministic artifact already exists but the run distribution row is missing
• THEN the platform MUST reuse the matching artifact, create or return the run distribution, and MUST NOT return duplicate_resource

Scenario: SCUM run self-update dispatch is idempotent

• WHEN POST /api/v1/server-instances/scum-alpha/run/update is retried with the same artifact, checksum, and idempotency key
• THEN the platform MUST return the existing update job and MUST NOT return duplicate_resource