# Composer Dock — projekt (krótki) Data: 2026-11-19 · Makieta: `docs/superpowers/mockups/herdr-composer-dock.html` (zaakceptowana przez użytkownika) ## Cel i powód Jednym kliknięciem wysłać do agenta często używaną komendę (np. `/handoff`, `/clear`) albo wstawić szablon promptu. Przyciski ma ustawiać sam użytkownik, z poziomu composera, bez edycji plików. ## Zakres - Dock: rząd przycisków w belce composera między ☆ a chipem statusu, w miejscu obecnego `div().flex_1()` (`main.js`, `renderCard`). Za ☆ jest separator. - Przycisk = `{ id, label, text, mode }`, gdzie `mode`: `"send"` (domyślnie) lub `"insert"`. - `send`: ta sama droga co Enter (kolejka, gdy agent pracuje; odliczanie; `--force` przy `blocked`; strażnik tożsamości agenta). Tekst w polu pozostaje nietknięty. - `insert`: wstawia `text` w miejscu kursora (jak Enter w panelu Historii), nic nie wysyła. - Wygląd: `send` ma pełne tło, `insert` przerywaną ramkę i znak ✎. - Nazwa domyślna: `text` skrócony do najwyżej 16 znaków (15 + „…”), białe znaki zwinięte do jednej spacji. Pełny tekst pokazuje tooltip. - **Dodawanie:** 1. w panelu Ulubione: prawy klik na wpis otwiera menu z opcjami Wstaw, Przypnij do docka / Odepnij z docka oraz Usuń z ulubionych; 2. prawy klik na ☆ otwiera menu „Przypnij bieżący tekst do docka” (nieaktywne przy pustym polu). - Nowy przycisk trafia na koniec docka. Tekst już przypięty nie jest dodawany drugi raz; menu pokazuje wtedy „Odepnij”. - **Prawy klik na przycisk w docku:** Zmień nazwę (edycja w miejscu: Enter zapisuje, Esc lub utrata fokusu anuluje, pusta nazwa wraca do domyślnej), Tylko wstawiaj / Wysyłaj od razu, Przesuń w lewo, Przesuń w prawo, Usuń z docka. - **Pusty dock:** szara podpowiedź „Prawy klik w Ulubionych → Przypnij do docka”. - **Przepełnienie:** dock przewija się poziomo (`overflow_x_scroll`). Chip i Wyślij nie są ruchome. - **Brak agenta** (fokus na zwykłym terminalu): przyciski są wyszarzone i nieaktywne, tak jak 🕘/☆. - **Zapis:** `shared.json`, klucz `herdr-composer.dock`. Dock jest jeden, wspólny dla wszystkich agentów. Limit 30 przycisków. Uszkodzone wpisy są pomijane, tak jak w historii i ulubionych. Nie dotyczy migracji z `ovis-composer` (nowy klucz). ## Zmiana istniejącego zachowania Dziś prawy klik na wiersz w panelu Historia/Ulubione od razu przełącza ulubione. Po zmianie otwiera menu. `Ctrl+D` nadal przełącza od razu. W zakładce Historia menu ma Wstaw i Dodaj do ulubionych / Usuń z ulubionych. ## Podejścia (rozważone) - Konfiguracja: plik JSON / edycja w composerze / oba. **Wybrane: w composerze** (decyzja użytkownika). - Klik: zawsze wysyła / zawsze wstawia / tryb per przycisk. **Wybrane: per przycisk, domyślnie wysyła** (makieta zaakceptowana). ## Poza zakresem Ikony lub emoji jako przyciski, skróty klawiszowe do przycisków, przeciąganie myszą do zmiany kolejności, osobne docki per agent lub per projekt, import i eksport. ## Dla wykonawcy - Czysta logika (`dock.js`: dodaj, usuń, przesuń, zmień nazwę, przełącz tryb, `isPinned`, `defaultLabel`, `normalize` z limitem) z testami w `tests/dock.test.mjs`. Odczyt i zapis w `storage.js` (`KEYS.dock`, `loadDock`, `saveDock`). - Menu: `Popover` z `gpui-kit`, otwierany prawym przyciskiem (`MouseButton "right"`). Jeśli nie da się go użyć w wierszach panelu (`on_item_secondary_click`), dopuszczalny jest własny popup pozycjonowany w miejscu kliknięcia. - Akcja `send` korzysta z istniejącej ścieżki wysyłania (bez duplikowania logiki kolejki). Wymagany test, że tekst w polu i draft nie zmieniają się. - Wysokość bloku (auto-fit) nie może rosnąć przez dock: dock ma stałą wysokość 28 px.