Copy for AI
operationToAiText(endpoint) to czysta funkcja (bez I/O, bez React), która zamienia znormalizowany endpoint w blok tekstu stojący za przyciskiem Copy for AI.
operationToAiText
Zdefiniowana w src/transformers/copy-for-ai.ts. Struktura wyniku: Purpose → Request → Responses → Error Responses → Validation.
Przypadki brzegowe
Przypadki brzegowe są obsługiwane jawnie, a nie zgadywane:
- Brak
requestBody→ brak sekcji Request. - Brak zadeklarowanych
4xx/5xx→ brak sekcji Error Responses. - Schematy
oneOf/anyOf→ oznaczane jako(one of N possible shapes)zamiast dowolnego wyboru jednego z nich. - Schemat bez ograniczeń → brak sekcji Validation.
- Długi opis bez
summary→ skracany do dwóch zdań w Purpose.
Wydajność i cykle
Generowanie stale mieści się wyraźnie poniżej 100ms (żaden spinner nie jest pokazywany), a rekurencyjne/cykliczne DTO są obsługiwane bezpiecznie.