Copy for AI

operationToAiText(endpoint) è una funzione pura (nessun I/O, nessun React) che trasforma un endpoint normalizzato nel blocco di testo dietro al pulsante Copy for AI.

operationToAiText

Definita in src/transformers/copy-for-ai.ts. Struttura dell'output: Purpose → Request → Responses → Error Responses → Validation.

Casi limite

I casi limite sono gestiti esplicitamente invece di essere indovinati:

  • Nessun requestBody → nessuna sezione Request.
  • Nessuna risposta 4xx/5xx dichiarata → nessuna sezione Error Responses.
  • Schema oneOf/anyOf → annotato come (one of N possible shapes) invece di sceglierne uno arbitrariamente.
  • Schema senza vincoli → nessuna sezione Validation.
  • Descrizione lunga senza summary → troncata a due frasi in Purpose.

Performance e cicli

La generazione resta stabilmente ben sotto i 100ms (nessuno spinner viene mostrato), e i DTO ricorsivi/circolari sono gestiti in sicurezza.