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

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

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

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

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

## 1.3.0 — 2026-09-27

- Добавлен ARD-манифест инструментов Vesremont, автоматически построенный из того же списка действий, что и `agent.json`.
- Канонический актуальный URL — `/.well-known/ard.json`; совместимый с Lighthouse 13.5 URL `/.well-known/ai-catalog.json` отдаёт тот же физический файл и не может разойтись с ним.
- HTML и HTTP discovery публикуют обе связи `ard` и `ai-catalog`; существующие `llms.txt`, `agent.json` и WebMCP остаются самостоятельными совместимыми точками входа.
- Локальный валидатор проверяет ARD 1.0/Lighthouse: обязательные поля, URN, тип ресурса, единственный `url` или `data`, representative queries и точное соответствие capabilities действиям `agent.json`.

## 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 проверяется генератором и валидатором.
- В [документации возможностей](https://vesremont.com/llms/capabilities.md) опубликован фактический ответ 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 главной странице, каталогу, фильтрам, карточкам товаров и другим динамическим страницам.