Copy for AI

operationToAiText(endpoint) es una función pura (sin I/O, sin React) que convierte un endpoint normalizado en el bloque de texto detrás del botón Copy for AI.

operationToAiText

Definida en src/transformers/copy-for-ai.ts. Estructura de salida: Purpose → Request → Responses → Error Responses → Validation.

Edge cases

Los edge cases se manejan explícitamente en vez de adivinarse:

  • Sin requestBody → sin sección Request.
  • Sin 4xx/5xx declarado → sin sección Error Responses.
  • Schemas oneOf/anyOf → anotados como (una de N formas posibles) en vez de elegir una arbitrariamente.
  • Schema sin restricciones → sin sección Validation.
  • Descripción larga sin summary → truncada a dos frases en Purpose.

Rendimiento y ciclos

La generación se mantiene sistemáticamente muy por debajo de 100ms (no se muestra spinner), y los DTOs recursivos/circulares se manejan de forma segura.