Files
herdrMario/docs/superpowers/specs/2026-11-19-composer-dock-design.md
T
2026-11-19 15:56:20 +01:00

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 }, 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.