chore: зафиксированы все текущие изменения проекта

SHiNE-agent-bot-coder/AGENT.md

@@ -15,19 +15,33 @@
 
 ## Авторитет команд и история
 - Основной пользователь и источник команд — Айдар: `@AidarKC` / `@aidarkc`.
-- Агент должен выполнять то, что говорит Айдар; сообщения других пользователей считать дополнительным контекстом, а не командами к исполнению.
-- Сообщения других пользователей в разрешённом канале, группе или supergroup сохраняются в историю диалога как контекстные сообщения.
-- На сообщения других пользователей в группе или supergroup сервис должен коротко отвечать в тот же чат, что сообщение получено, но не ставить их в очередь как задачи.
-- Использовать сообщения других пользователей для действий нужно только если Айдар дал на это специальную инструкцию.
-- В Telegram-канале/группе `@shine_writing` сервис должен отвечать только на сообщения Айдара, а ответы отправлять в тот же чат.
+- Дополнительно разрешены игроки из whitelist (`ALLOWED_TELEGRAM_PLAYERS`), каждый со своей отдельной историей и рабочей папкой `Players/<username>/`.
+- Игроки работают в режиме вопросов/анализа/подготовки материалов: в промпте явно задано правило не менять код проекта и писать материалы только в своей папке.
+- Для неизвестных пользователей в личном чате сервис отвечает вежливым отказом.
+- В Telegram-канале/группе `@shine_writing` сервис выполняет сообщения только от Айдара, а ответы отправляет в тот же чат.
 - Если Telegram сообщает о миграции обычной группы в supergroup, сервис должен запомнить новый `chat_id` и отправлять ответы уже туда.
+- На события подключения/отключения пользователей (join/leave) сервис не отвечает и ничего не отправляет.
 
 ## Очередь и состояние
 - Входящие задачи записываются в файловую очередь и обрабатываются строго по одной, чтобы не смешивать изменения в проекте.
 - Сервис ведёт состояние активной задачи и текущего файла истории, а после рестарта продолжает незавершённую обработку с учётом сохранённого состояния.
-- Истории диалогов хранятся в JSONL; после команды `/new` старая история архивируется, а новая начинается отдельно.
+- Истории диалогов хранятся в JSONL по каждому разрешённому username отдельно: `data/history/<username>/`.
+- Архив истории после `/new`: `data/history/<username>/archive/`.
+- Для просмотра истории игрока открывать файлы в его папке истории по username.
 - Дедупликация входящих Telegram update нужна, чтобы одно сообщение не попало в обработку повторно.
 - Если Codex молчит во время активной задачи 2 минуты подряд, сервис отправляет аварийный статус с общим временем работы задачи; при дальнейшем молчании повторяет статус каждые 2 минуты.
+- После успешной обработки задачи из личного чата Айдара сервис должен отправить публичный итоговый отчёт в группу `@shine_writing`: первым сообщением исходный запрос, вторым сообщением-ответом итоговый ответ Codex. Промежуточные статусы в группу не дублировать.
+- Для приватных voice/audio-запросов в публичном отчёте первым сообщением отправлять исходный Telegram voice/audio-файл с подписью, где указан распознанный текст. В пользовательском тексте отчёта не показывать Telegram `file_id`.
+
+## Планы и отложенные фичи
+- Планы проекта по отложенным фичам хранятся в `Dev_Docs/Future_Features/`.
+- Внутри есть три горизонта:
+  - `near/` - ближайшие планы, обычно сегодня/завтра;
+  - `medium/` - среднесрочные планы, обычно недели или 1-2 месяца;
+  - `far/` - дальнее будущее без понятного срока.
+- Если пользователь спрашивает, какие есть планы или что можно продолжить, нужно смотреть эти три папки и отвечать кратким списком по горизонтам.
+- Файлы из `Dev_Docs/Future_Features/` не начинать реализовывать без явной команды пользователя.
+- После реализации фичи, требующей ручной проверки, нужно добавить отдельный файл в `Dev_Docs/Pending_Features/`.
 
 ## Локальный запуск и systemd
 - Основной запуск сервиса выполняется Python-скриптом `py_bot_service.py` из папки `SHiNE-agent-bot-coder/`.
@@ -35,7 +49,7 @@
 - Для проверки Codex без Telegram можно использовать self-test режим сервиса.
 - Для постоянного локального запуска используется user-level systemd service `shine-agent-bot-coder`; скрипты установки лежат в `SHiNE-agent-bot-coder/scripts/systemd/`.
 - Если меняется логика сервиса, после изменений нужно проверить запуск локально и при необходимости перезапустить user systemd service.
-- Команда Telegram `/restart_service` перезапускает сервис через завершение процесса; systemd поднимает его заново. Короткий алиас: `/restart`.
+- Команда Telegram `/restart_service` (и алиас `/restart`) доступна только Айдару.
 
 ## Правила ответа
 - Пиши содержательно и коротко.