# Solution: typed AI GameMaster orchestration

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

LLM adapters получают immutable, audience-specific projection. Intent adapter
возвращает `CommandProposal | Clarification`; kernel независимо выполняет
schema/authorization/rules/RNG/commit. Narrator вызывается только с committed
event и новой projection. Canonical implementation живёт в shared
vertical-slice; локальный wrapper не копирует domain logic, а утверждает
исследовательские acceptance criteria.

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

`raw intent → audience projection → proposal/clarification → schema →
authorization → rules → server RNG → append event → reduce state →
post-commit audience projection → narration`

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

Исполнимая реализация находится в соседнем интеграционном исследовании
[`../2026-07-25-ai-gm-vertical-slice/prototype/`](../2026-07-25-ai-gm-vertical-slice/prototype/).
Локальный [`prototype/verify.ts`](prototype/verify.ts) запускает boundary
проверку без provider network calls. Он объединяет `runDemo`,
`runAdversarialSuite` и adapter metadata из `runBenchmark`, затем завершает
процесс ненулевым exit при нарушении любого AC.

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

- Node.js 24.14.0;
- npm 11.9.0;
- TypeScript 7.0.2;
- внешние сервисы: none.

## Установка

```bash
npm ci
```

## Запуск

```bash
node RnD/technical/2026-07-25-ai-gm-orchestration/prototype/verify.ts
```

Ожидается JSON с `"status": "pass"`, одинаковыми accepted/narration versions,
нулевыми mutation/leakage rates и `realProviderCalls: 0`.

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

```bash
node --test RnD/technical/2026-07-25-ai-gm-vertical-slice/prototype/tests/*.test.ts
npm run test:technical
npm run typecheck
npm run technical:demo
```

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

Конфигурация и secrets не требуются. Real-provider environment variables
намеренно отсутствуют.

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

Fake parser распознаёт только fixtures и не доказывает natural-language или
provider structured-output coverage. Wrapper читает shared implementation:
изменение central report contract должно атомарно обновлять wrapper и evidence.
Любой будущий provider adapter обязан сохранять тот же typed boundary и не
получать canonical write capability.

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

Provider-specific schema conformance benchmark, secret management, retry budget,
trace redaction, policy review и human escalation.