dust-hive

dust-hive to narzędzie CLI do uruchamiania kilku niezależnych środowisk deweloperskich Dust jednocześnie. Każde środowisko otrzymuje własny git worktree, zakres portów, kontenery Docker i instancje baz danych (Postgres, Qdrant, Elasticsearch). Automatycznie ładuje zmienne środowiskowe przez direnv, eliminując konflikty między portami i umożliwiając uruchamianie testów bez zakłóceń. Idealne dla deweloperów pracujących nad wieloma gałęziami lub funkcjami równolegle.

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.