docs: требование публиковать схемы (raw.json) на сайт + режим /_api/file в отчёте

HISTORY/2026-10-12_code_review_and_fixes.md

@@ -71,3 +71,22 @@
 
 Пункты 3–5 из «Найдено» (XFF, мёртвая ветка дедупа, кэш без TTL, юнит-тесты) —
 оставлены как есть: не мешают текущей работе; вернуться при масштабировании/переработке.
+
+## Режим «редактор файла» (добавлено в этой же сессии)
+
+Новый эндпоинт `POST /<stand>/_api/file` (`filemode.js`): тело `{content, instruction}`
+→ ответ `{content, changes[], warnings[]}`. LLM возвращает ПОЛНЫЙ обновлённый файл
+(обычно `terraform.tfvars`). Опирается на текстовый `search_index.json`; секреты сюда
+не кладут (отдельный `secrets.auto.tfvars`), логируются только размеры.
+
+## Следующий этап — требования (НЕ реализовано)
+
+- **Схемы (YAML/raw.json) надо публиковать на сайт.** Чтобы режим `/_api/file` (и
+  любой LLM-режим на бэкенде) проверял файл ПО СХЕМЕ, спеки
+  `provider/resources_yaml/*.yaml` / `stack/<stand>/<svc>/raw.json` нужно отдавать
+  эндпоинтом (напр. `GET /<stand>/_api/schema?resource=...`) рядом со статикой.
+  Сейчас `/_api/file` опирается только на текстовые доки — схемы бэкенду недоступны.
+- **`AGENTS.md` для IDE-агентов** — сделан в `tf_provider` (самодостаточный: структура
+  `raw.json`, инвентарь 35 ресурсов, workflow, секреты, типичные ошибки).
+- **MCP** — отложен: требует ручной настройки у юзера в IDE (на этом этапе исключено);
+  ставка на zero-config `AGENTS.md` + режим `/_api/file`.