Copy for AI

operationToAiText(endpoint) — это чистая функция (без ввода-вывода и без React), которая превращает нормализованный эндпоинт в текстовый блок за кнопкой Copy for AI.

operationToAiText

Описана в src/transformers/copy-for-ai.ts. Структура результата: Purpose → Request → Responses → Error Responses → Validation.

Edge cases

Пограничные случаи разобраны явно, а не угаданы:

  • Нет requestBody → нет раздела Request.
  • Не объявлены 4xx и 5xx → нет раздела Error Responses.
  • Схемы с oneOf и anyOf → помечаются как (one of N possible shapes), вместо того чтобы наугад выбрать одну.
  • Схема без ограничений → нет раздела Validation.
  • Длинное описание без summary → в Purpose обрезается до двух предложений.

Производительность и циклы

Генерация стабильно укладывается в сотню миллисекунд, поэтому спиннер не показывается, а рекурсивные и зацикленные DTO обрабатываются безопасно.