nims-story-master

name	nims-story-master
description	Работа мастера-сюжетника с НИМС через MCP: персонажи, сюжеты, события, адаптации, отношения, группы, вводные, мета проекта, поиск, проверка целостности. Использовать при работе с НИМС, LARP, ролевыми играми, вводными, сюжетом, персонажами, событиями, базой НИМС, или когда подключён MCP-сервер nims/nims-readonly.

Мастер-сюжетник в НИМС

НИМС — редактор вводных для ролевых игр. В server-режиме доступен MCP: читать и менять базу через tools/resources.

Документация подключения: packages/wiki/MCP_RU.md. Справочник параметров tools: tools-reference.md.

Перед началом

1. Убедиться, что MCP nims или nims-readonly подключён и отвечает.
2. Для разведки и обзора — readonly (/mcp/readonly). Для записи — full (/mcp).
3. Сначала прочитать контекст, потом писать:
   • get_meta — название игры, даты, описание
   • list_characters / list_stories
   • при необходимости resource nims://meta, nims://characters, nims://stories
4. Токен MCP = права того пользователя, под которым получен на /mcp/auth. Игрокам MCP недоступен.

Модель данных (кратко)

Сущность	Что это	Ключевые tools
Мета	Название игры, даты, описание	get_meta, set_meta
Персонаж	Роль игрока, поля профиля	create_character, get_character, update_character_field
Сюжет	Линия с мастер-текстом	create_story, set_story_text, get_story
Событие	Сцена внутри сюжета (общий текст + время)	create_event, update_event
Адаптация	Персональный текст/время/готовность в событии	set_event_adaptation
Отношение	Связь двух персонажей (текст с каждой стороны)	create_relation, set_relation_text
Группа	Набор персонажей с общим текстом	create_group, get_group
Вводная	Вводная игрока (профиль + сюжеты + отношения)	export_briefings, get_briefing, import_briefings

Иерархия участия: персонаж → добавлен в сюжет → добавлен в событие → можно писать адаптацию.

Обязательный порядок мутаций

Нарушение порядка даёт errors-entity-is-not-exist или пустые адаптации.

create_character
  → create_story
  → add_character_to_story
  → create_event
  → add_character_to_event      ← перед set_event_adaptation
  → set_event_adaptation

• Индексы событий с нуля (eventIndex: 0 — первое событие).
• set_story_text — мастер-текст сюжета (что видит мастер); set_event_adaptation type:text — что видит игрок в сцене.
• Отметить готовность адаптации: set_event_adaptation с type: ready, value: true.

Типовые сценарии

Обзор проекта (без записи)

get_meta → list_characters → list_stories
→ get_statistics
→ get_consistency_check

При большом проекте — search_text по ключевым словам (textTypes: writerStory, eventAdaptations, characterProfiles, relations).

Новый персонаж и сцена

1. get_profile_structure с type: character — узнать поля профиля.
2. create_character → update_character_field для полей (тип поля = itemType из структуры).
3. Сюжет и событие — по цепочке из раздела «Обязательный порядок».
4. get_character_report — проверить, как выглядит вводная.

Отношения между персонажами

1. create_relation (fromCharacter, toCharacter).
2. set_relation_text дважды — от лица каждого (character = имя того, чей текст задаёте).
3. get_character_relation — проверить.

Массовая правка вводных

1. export_briefings с format: markdown и selCharacters / selStories — выгрузить нужное.
2. Правки в markdown вне НИМС или точечно set_event_adaptation / update_character_field.
3. Обратная загрузка: import_briefings с JSON из export_briefings (меняются text / displayTime в eventsInfo).
4. get_consistency_check после крупных изменений.

Резервная копия и перенос

• Бэкап: export_database → сохранить JSON в файл.
• Восстановление: import_database (только admin), по умолчанию preserveManagementInfo: true.
• Чистый старт: load_database_preset — empty, demo, negriat (только admin).

Права доступа

Роль	Чтение MCP	Запись	Admin-only
organizer	да	свои сущности + создание новых	нет
editor (назначен в НИМС)	да	любые сюжеты/персонажи	нет
admin	да	admin-операции	set_meta, import_database, load_database_preset
player	нет	нет	—

При назначенном редакторе обычный организатор не может править тексты сюжетов (errors-forbidden-for-non-editor) — только редактор или admin для admin-задач.

Редактировать поля чужого персонажа без роли редактора нельзя (errors-organizer-is-not-an-owner).

Правила для ассистента

1. Не выдумывать имена — перед ссылкой на персонажа/сюжет вызвать list_* или get_*.
2. Минимальные записи — менять только то, о чём просят; не перезаписывать базу без явного запроса.
3. Перед удалением (remove_character, remove_story, remove_event) — предупредить: операция необратима.
4. После пакета правок — get_consistency_check; при ошибках сообщить список.
5. Имена — кириллица допустима; в resource URI кодировать: nims://character/Имя%20Персонажа.
6. Большие ответы — для обзора использовать list_*, get_story_events, search_text, а не export_database целиком.
7. Вводные игроку — отдавать markdown из export_briefings, не сырой JSON, если пользователь не просит иначе.

Чеклист качества сюжета

Перед сдачей блока работы мастеру:

- [ ] У каждого игрового персонажа есть профиль и хотя бы один сюжет
- [ ] Персонажи добавлены в сюжет и в события, где им нужны адаптации
- [ ] Адаптации согласованы с мастер-текстом события (нет противоречий)
- [ ] Отношения созданы и тексты заполнены с обеих сторон (если нужны)
- [ ] get_consistency_check без ошибок
- [ ] export_briefings по персонажу читается как цельная вводная

Шаблон ответа мастеру

После выполнения задачи кратко сообщить:

## Сделано
- [список изменений с именами сущностей]

## Проверка
- consistency: [OK / N ошибок]
- затронуто: N персонажей, M сюжетов

## Замечания
- [противоречия, незаполненные адаптации, нужные следующие шаги]

Ошибки MCP

Сообщение	Действие
401 Unauthorized	Новый токен на /mcp/auth
errors-forbidden-for-role	Токен игрока — нужен организатор
errors-forbidden-for-non-admin	Нужен admin или другой tool
errors-forbidden-for-non-editor	Нужен редактор или снять режим редактора
errors-entity-is-not-exist	Проверить имя; выполнить add_character_to_story / add_character_to_event
errors-organizer-is-not-an-owner	Нет прав на чужую сущность

Дополнительно

• Полный список tools и параметры: tools-reference.md
• Настройка клиента: packages/wiki/MCP_RU.md
• Тесты MCP: npm run test:mcp и npm run test:mcp:permissions в packages/nims-server