3.7 KiB
3.7 KiB
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 }, gdziemode:"send"(domyślnie) lub"insert".send: ta sama droga co Enter (kolejka, gdy agent pracuje; odliczanie;--forceprzyblocked; strażnik tożsamości agenta). Tekst w polu pozostaje nietknięty.insert: wstawiatextw miejscu kursora (jak Enter w panelu Historii), nic nie wysyła.- Wygląd:
sendma pełne tło,insertprzerywaną ramkę i znak ✎.
- Nazwa domyślna:
textskrócony do najwyżej 16 znaków (15 + „…”), białe znaki zwinięte do jednej spacji. Pełny tekst pokazuje tooltip. - Dodawanie:
- w panelu Ulubione: prawy klik na wpis otwiera menu z opcjami Wstaw, Przypnij do docka / Odepnij z docka oraz Usuń z ulubionych;
- 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, kluczherdr-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 zovis-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,normalizez limitem) z testami wtests/dock.test.mjs. Odczyt i zapis wstorage.js(KEYS.dock,loadDock,saveDock). - Menu:
Popoverzgpui-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
sendkorzysta 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.