session-execution

Use when working on or reviewing session execution, command handling, shell state, FIFO-based streaming, or stdout/stderr separation. Relevant for session.ts, command handlers, exec/execStream, or anything involving shell process management. (project)

1. Zainstaluj umiejętność session-execution z repozytorium Cloudflare sandbox-sdk, dodając ją do swojego projektu jako skill w konfiguracji MCP.
2. Przeczytaj dokumentację docs/SESSION_EXECUTION.md aby zrozumieć architekturę niezawodnego wykonywania poleceń i separacji strumieni wyjścia.
3. Podczas debugowania poleceń shell zwróć uwagę na wybrany tryb wykonania: jeśli pracujesz z exec, pamiętaj że stan persystuje w głównym shellu i używane są pliki tymczasowe do przechwycenia wyjścia; jeśli z execStream lub startProcess, wiesz że polecenia działają w podshelu przez FIFO z prefiksami etykiet.
4. Weryfikuj obsługę kodów wyjścia poprzez sprawdzenie atomowych operacji zapisu do pliku .exit (najpierw do .tmp, potem mv) oraz upewnij się że FIFO są czyszczone w ścieżkach błędów.
5. Testuj polecenia niemające wyjścia (cd, przypisanie zmiennej) oraz duże wyjścia aby wykryć potencjalne zawieszenia lub problemy z buforowaniem logów.
6. Analizując wyścigi danych pamiętaj że mutex serializuje wykonanie poleceń w sesji — sprawdź czy operacje zachodzą w tej samej sesji (chronione mutexem) czy między sesjami (tam wyścigi są możliwe).