Copy for AI

operationToAiText(endpoint) é uma função pura (sem I/O, sem React) que transforma um endpoint normalizado no bloco de texto por trás do botão Copy for AI.

operationToAiText

Definida em src/transformers/copy-for-ai.ts. Estrutura do output: Purpose → Request → Responses → Error Responses → Validation.

Edge cases

Casos-limite são tratados explicitamente em vez de chutados:

  • Sem requestBody → sem seção Request.
  • Sem 4xx/5xx declarado → sem seção Error Responses.
  • Schemas oneOf/anyOf → anotados como (one of N possible shapes) em vez de escolher um arbitrariamente.
  • Schema sem constraints → sem seção Validation.
  • Descrição longa sem summary → truncada para duas sentenças no Purpose.

Performance e ciclos

Geração fica consistentemente bem abaixo de 100ms (nenhum spinner é mostrado) e DTOs recursivos/circulares são tratados com segurança.