Ручная n8n-нода — это техдолг с отсрочкой.

Ручная n8n-нода — это техдолг с отсрочкой.
API меняется, а код, SDK и дока живут в разных ветках реальности. Итог: одна правка — три места забыли обновить.

Здесь сделали нормально: один `.tsp`-файл как source of truth.
Из него генерятся:
- OpenAPI
- документация
- SDK
- n8n-нода

Что это даёт на практике:
1. нет расхождения между API и интеграцией;
2. CI собирает и публикует артефакты автоматически;
3. нода не может «устареть» быстрее, чем спецификация.

Ключевой момент — первую рукописную версию выбросили целиком. И это правильно: если артефакт можно генерировать, вручную его поддерживать уже лишняя поверхность отказа. 🔧

Хороший паттерн для любого интеграционного слоя: один источник данных, всё остальное — производная.