developing-genkit-tooling

Best practices for authoring Genkit tooling, including CLI commands and MCP server tools. Covers naming conventions, architectural patterns, and consistency guidelines.

1. Zapoznaj się z konwencją nazewnictwa dla komend CLI: używaj kebab-case z dwukropkami jako separatorami (np. flow:run, eval:run). W kodzie argumenty piszesz camelCase (flowName), ale w tekście pomocy używasz standardowego formatu (<flowName>).

2. Dla narzędzi MCP stosuj snake_case (np. list_flows, run_flow), aby zachować spójność ze standardami MCP.

3. Implementując komendy CLI w cli/src/commands/, użyj narzędzia runWithManager do zarządzania cyklem życia runtime'u projektu. Importuj runWithManager z ../utils/manager-utils i opakowuj logikę interakcji z managerem wewnątrz funkcji callback.

4. Formatuj wyjście komend za pomocą logger z @genkit-ai/tools-common/utils. Jeśli komenda generuje dane, udostępnij opcje JSON lub zapisu do pliku. Dla operacji wspierających streaming (jak flow:run) dodaj flagę --stream i kieruj wyjście na stdout.

5. Rozróżnij między narzędziami statycznymi (np. dokumentacja, które nie wymagają kontekstu projektu) a narzędziami runtime'owymi (wymagającymi uruchomionego projektu Genkit). Każdy typ ma inny wzorzec rejestracji i zależności.