Copy for AI
operationToAiText(endpoint) est une fonction pure (pas d'E/S, pas de React) qui transforme un endpoint normalisé en le bloc de texte derrière le bouton Copy for AI.
operationToAiText
Défini dans src/transformers/copy-for-ai.ts. Structure de sortie : Purpose → Request → Responses → Error Responses → Validation.
Cas limites
Les cas limites sont gérés explicitement plutôt que devinés :
- Pas de
requestBody→ pas de section Request. - Pas de
4xx/5xxdéclaré → pas de section Error Responses. - Schémas
oneOf/anyOf→ annotés comme(une parmi N formes possibles)au lieu d'en choisir une arbitrairement. - Schéma sans contrainte → pas de section Validation.
- Description longue sans
summary→ tronquée à deux phrases dans Purpose.
Performance et cycles
La génération reste systématiquement bien en dessous de 100 ms (aucun indicateur de chargement n'est affiché), et les DTO récursifs/circulaires sont gérés sans risque.