# Solution: integrated AI GameMaster vertical slice

## Выбранный подход

Strict TypeScript data contracts validated by Ajv, pure semantic validators and
reducers, injected authoritative RNG, append-only in-memory event log,
audience-specific projections, fake typed adapters and deterministic benchmark.

## Архитектура и поток данных

`HostPreferences → proposed Adventure/Map → schema + semantic validation →
initial state → player intent → typed proposal → schema → authorization →
rules → server RNG → event append → pure reduce → projection → fake narration
→ telemetry → replay → state hash`

## Структура прототипа

- `src/contracts.ts` — domain types.
- `src/schemas.ts` — versioned JSON Schemas.
- `src/validators.ts` — schema/content/map validation.
- `src/engine.ts` — rules, authorization and reducer.
- `src/event-log.ts` — append/idempotency/replay.
- `src/projection.ts` — visibility enforcement.
- `src/orchestrator.ts` — adapter boundary.
- `src/adversarial.ts` — named threat corpus runner.
- `src/property-harness.ts` — generated invariant cases.
- `src/long-session.ts` — 1,000-event checkpoint proof.
- `src/benchmark.ts` — baseline/candidate harness.
- `src/cli.ts` — demo and benchmark commands.
- `fixtures/` — original host/content/map/corpus inputs.
- `tests/` — behavioral, adversarial and property checks.

## Требования

- macOS/Linux;
- Node.js 24.12+ (verified runtime 24.14.0);
- Bun 1.3.6 for the optional runtime smoke lane;
- npm 11.9.0;
- TypeScript 7.0.2;
- Ajv 8.20.0;
- fast-check 4.9.0;
- external services: none.

## Установка

```bash
npm ci
```

## Запуск

```bash
npm run technical:demo
npm run technical:benchmark
bun run RnD/technical/2026-07-25-ai-gm-vertical-slice/prototype/src/cli.ts demo
```

## Тестирование

```bash
npm run check
```

## Конфигурация

Нет environment variables, providers или secrets. Seed находится в fixture и
выводе команды.

## Ограничения и безопасность

In-memory log, fake adapters и synthetic content нельзя переносить в production
как persistence, model evaluation или finished adventure. Host input и generated
contracts остаются недоверенными до validation.

Dedicated Adventure/Map studies define richer authoring contracts, while this
slice uses separate minimal runtime contracts. Их interop не реализован и не
входит в полученное доказательство.

## Условия переноса в production

Shared versioned authoring/runtime contract package или explicit compiler with
cross-contract tests; затем durable transactional store, authentication,
signed/audited event integrity,
schema migrations, multi-process concurrency, provider benchmark, content
moderation, observability/redaction, load/recovery tests и independent review.