tui-validate

Validates Terminal User Interface (TUI) output using freeze for screenshot capture and LLM-as-judge for semantic validation. Supports both visual (PNG/SVG) and text-based validation modes.

1. Zainstaluj wymagane narzędzia: freeze (narzędzie do przechwytywania zrzutów terminalowych) oraz tmux (opcjonalnie, do pracy z interaktywnymi aplikacjami). Uruchom brew install charmbracelet/tap/freeze, a następnie sprawdź instalację poleceniami freeze --version i tmux -V.

2. Przygotuj cel walidacji — możesz użyć jednego z czterech typów: pliku z wyjściem ANSI (file:ścieżka), polecenia do wykonania (command:polecenie), sesji tmux (tmux:sesja) lub surowego tekstu (buffer:tekst).

3. Zdefiniuj kryteria walidacji — opisz, co powinna sprawdzać walidacja. Możesz użyć wbudowanych kryteriów lub napisać własne, np. "sprawdź, czy menu jest widoczne w górnej części ekranu" lub "potwierdź, że licznik pokazuje wartość większą niż 0".

4. Uruchom skill, podając parametry target (co walidować) i criteria (jakie warunki muszą być spełnione). Opcjonalnie ustaw format wyjścia na svg (domyślnie) lub png, w zależności od potrzeb dokumentacji.

5. Skill przechwyta wyjście TUI, generuje zrzut ekranu i analizuje go za pomocą modelu AI, sprawdzając czy spełnia podane kryteria. Otrzymasz wynik walidacji wskazujący, czy interfejs wygląda prawidłowo.

6. Użyj wyników do testowania regresji wizualnej — powtarzaj walidację po zmianach w kodzie, aby upewnić się, że interfejs nadal działa poprawnie bez łamania na drobnych zmianach formatowania.