Версии и изменения AI-документации Vesremont

Текущая версия AI-документации и публичного агентского контракта: 1.2.0.

Версия имеет формат MAJOR.MINOR.PATCH:

• MAJOR меняется при несовместимом изменении структуры agent.json, удалении или несовместимом изменении инструмента;
• MINOR меняется при добавлении инструмента, поля результата или новой документированной возможности с сохранением совместимости;
• PATCH меняется при уточнении текста, примера или метаданных без изменения действующего контракта.

Криптографическая ревизия sha256:... дополняет версию и позволяет проверить точное содержимое текущего набора документов. Версия объясняет смысл изменения, а ревизия меняется при любом изменении канонических Markdown-файлов.

1.2.0 — 2026-09-26

• Добавлено содержательное Markdown-представление главной /llms/home.md, которое генератор строит из общего структурированного источника главной страницы.
• GET / с явным Accept: text/markdown получает этот документ без redirect и с Content-Type: text/markdown; charset=utf-8; обычные браузерные запросы продолжают получать HTML.
• HTML и Markdown представления корневого URL разделены заголовком Vary: Accept, чтобы промежуточные кэши не смешивали форматы.
• Title, description, основные покупательские сведения, сценарии получения и оплаты и FAQ главной используют тот же источник данных, что и Markdown.
• Из robots.txt удалена устаревшая директива Host; AI-группы, Content-Signal, Clean-param, правила доступа и Sitemap не изменены.

1.1.0 — 2026-09-25

• В общую full-access группу десяти AI User-Agent добавлен Crawl-delay: 0 как явный сигнал без искусственного замедления обхода.
• Allow: / сохранён: доступ к публичному контенту и допустимая частота запросов не ограничиваются. Парсеры, не принимающие нулевое значение нестандартной директивы, могут безопасно её игнорировать.
• Googlebot не входит в эту группу и не поддерживает Crawl-delay; YandexBot продолжает использовать прежнюю группу User-agent: *, а Яндекс не учитывает Crawl-delay с 2018 года.
• Валидатор требует ровно один Crawl-delay: 0 в общей группе и не допускает его появления в остальных группах.

1.0.1 — 2026-09-25

• Десять явно разрешённых AI User-Agent объединены в одну стандартную robots.txt-группу с общим Allow: /.
• Политика доступа не изменилась: каждый из десяти токенов по-прежнему получает полный доступ и не входит в restrictive-группы.
• Валидатор проверяет единую группу, уникальность каждого токена и отсутствие дополнительных Allow или Disallow внутри неё.
• Группы Googlebot, YandexBot, остальных crawler-ов, Content-Signal, Host и Sitemap не изменялись.

1.0.0 — 2026-09-25

• Зафиксирован текущий публичный baseline agent.json формата AWP 0.2.
• Зафиксирован набор реально зарегистрированных WebMCP-инструментов для чтения страниц, каталога, карточки товара, корзины, избранного и checkout.
• Связь каждого действия agent.json с одноимённой операцией WebMCP проверяется генератором и валидатором.
• В документации возможностей опубликован фактический ответ read-only инструмента get_cart, полученный через document.modelContext на production 25 сентября 2026 года.
• Добавлено это версионируемое описание изменений; последующие изменения структуры agent.json, состава инструментов, аргументов или результатов должны получать новую запись и новую версию.

Публикация и актуальность

Канонические файлы /llms/*.md собираются один раз в сутки в /llms-full.txt и HTML-зеркала /for_ai/. Текущая версия и точная SHA-256-ревизия публикуются в сгенерированных документах.

/llms-full.txt является статическим текстовым ресурсом и использует следующую политику:

• TTL клиентского кэша — 1 час: Cache-Control: max-age=3600;
• Nginx публикует фактические ETag и Last-Modified статического файла;
• после истечения TTL клиенту следует выполнить условный запрос с If-None-Match или If-Modified-Since;
• если файл не изменился, Nginx может ответить 304 Not Modified; если изменился — вернуть новую полную версию и новые валидаторы кэша.

Эта политика относится к статическому /llms-full.txt. Она не назначает Last-Modified или часовой TTL главной странице, каталогу, фильтрам, карточкам товаров и другим динамическим страницам.