Copy for AI

operationToAiText(endpoint)は純粋関数(I/Oなし、Reactなし)で、正規化されたエンドポイントを「Copy for AI」ボタンの背後にあるテキストブロックに変換します。

operationToAiText

src/transformers/copy-for-ai.tsで定義されています。出力構造: Purpose → Request → Responses → Error Responses → Validation。

Edge cases

エッジケースは推測ではなく明示的に処理されます。

  • requestBodyがない場合 → Requestセクションなし。
  • 4xx/5xxが宣言されていない場合 → Error Responsesセクションなし。
  • oneOf/anyOfスキーマ → 恣意的に1つを選ぶのではなく(one of N possible shapes)と注釈されます。
  • 制約のないスキーマ → Validationセクションなし。
  • summaryのない長い説明文 → Purposeでは2文に切り詰められます。

パフォーマンスと循環参照

生成は常に100ms未満を安定して保ちます(スピナーは表示されません)。再帰的/循環参照のあるDTOも安全に処理されます。