From a3c792c77a8dc06a3cc97dae51555dd17cfddb02 Mon Sep 17 00:00:00 2001
From: Repinoid <tazet@narod.ru>
Date: Mon, 12 Oct 2026 08:46:07 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D1=82=D1=80=D0=B5=D0=B1=D0=BE=D0=B2?=
 =?UTF-8?q?=D0=B0=D0=BD=D0=B8=D0=B5=20=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D0=BA?=
 =?UTF-8?q?=D0=BE=D0=B2=D0=B0=D1=82=D1=8C=20=D1=81=D1=85=D0=B5=D0=BC=D1=8B?=
 =?UTF-8?q?=20(raw.json)=20=D0=BD=D0=B0=20=D1=81=D0=B0=D0=B9=D1=82=20+=20?=
 =?UTF-8?q?=D1=80=D0=B5=D0=B6=D0=B8=D0=BC=20/=5Fapi/file=20=D0=B2=20=D0=BE?=
 =?UTF-8?q?=D1=82=D1=87=D1=91=D1=82=D0=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 HISTORY/2026-10-12_code_review_and_fixes.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/HISTORY/2026-10-12_code_review_and_fixes.md b/HISTORY/2026-10-12_code_review_and_fixes.md
index 8635dfa..9d61ccd 100644
--- a/HISTORY/2026-10-12_code_review_and_fixes.md
+++ b/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`.