Prototype: Game Contract Boundary Verification

This directory contains five executable contract tests against the shared AI-GM vertical-slice implementation. It does not contain a duplicate Game Contract, validator, engine, state service or projection implementation.

Authoritative dependencies:

• ../../2026-07-25-ai-gm-vertical-slice/prototype/src/fixtures.ts provides loadFixtureBundle();
• ../../2026-07-25-ai-gm-vertical-slice/prototype/fixtures/game-contract.json is the single Game Contract/rules-profile fixture;
• the shared contracts, engine, event-log, hash, orchestrator, projection, state and validators modules are imported directly by game-contract.verification.test.ts.

Run from the repository root on Node.js v24.14.0:

node --test RnD/technical/2026-07-25-game-contract-canonical-state/prototype/game-contract.verification.test.ts

Run from the study directory:

node --test prototype/game-contract.verification.test.ts

The recorded result is 5 tests, 5 pass, 0 fail, 0 skipped and 0 TODO:

• AC-01 rejects all labelled invalid commands before RNG/event/state work;
• AC-02 keeps narrator projection/output mutations outside canonical state;
• AC-03 accepts the supported contract and returns structured errors for missing, ill-typed and unsupported contract/state versions;
• AC-04 matches explicit participant allow-lists for player, GM, party, branch and public visibility cases.

Unsupported contractVersion and stateVersion values 999.0.0 are asserted to produce schema_const issues at /game/contractVersion and /game/stateVersion.

Run the root compiler separately:

npm run typecheck

The final compiler run exits successfully. No experimental Node flag, network service, environment variable or study-local dependency install is required.