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/. Локальный 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.

Установка#

npm ci

Запуск#

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

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

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

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.