dust-hive

Information about dust-hive, a CLI tool for running multiple isolated Dust development environments. ALWAYS enable this skill when the working directory is under ~/dust-hive/. Use for understanding port allocation, running tests, and working with the environment.

1. Sprawdź, czy pracujesz w środowisku dust-hive, uruchamiając polecenie pwd i szukając ścieżki ~/dust-hive/{nazwa-środowiska}/. Jeśli katalog zawiera plik .git (nie katalog), potwierdzasz, że jesteś w git worktree.
2. Zainstaluj direnv na swojej maszynie, aby automatycznie ładować zmienne środowiskowe. Gdy wejdziesz do katalogu worktree, zmienne takie jak FRONT_DATABASE_URI, CORE_API i CONNECTORS_API będą dostępne bez ręcznego konfigurowania.
3. Sprawdź stan środowiska poleceniem dust-hive status [NAZWA_ŚRODOWISKA], aby dowiedzieć się, czy jest ono zatrzymane (stopped), w trybie zimnym (cold – tylko SDK watch) czy ciepłym (warm – wszystkie usługi i Docker).
4. Jeśli zmienne środowiskowe nie załadowały się automatycznie, ręcznie załaduj je poleceniem source ~/.dust-hive/[NAZWA_ŚRODOWISKA]/.envrc.
5. Uruchamiaj testy w zależności od stanu środowiska: w stanie zimnym możesz uruchamiać testy frontendowe na wspólnej testowej bazie danych, a w stanie ciepłym masz dostęp do wszystkich usług (front, core, connectors, oauth, workers) z izolowanymi kontenerami Docker.
6. Każde środowisko ma dedykowany zakres portów, co eliminuje konflikty – możesz pracować nad wieloma gałęziami jednocześnie bez restartowania usług.