Compare commits

...
27 Commits
Author SHA1 Message Date
FactorandOvis Fast dc5dcc9cc6 feat: the composer reads agent profiles from composer-agents.json
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-20 08:58:36 +01:00
FactorandOvis Fast 1b12550d04 feat: the / menu reads the sources of the agent's profile and its history
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-20 08:57:24 +01:00
FactorandOvis Fast 0263eca263 test: pin the / menu of Claude Code before profiles
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-20 08:55:14 +01:00
FactorandOvis Fast 1a78b5dcf3 feat: agent profiles describe each agent's commands
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-20 08:54:16 +01:00
FactorandClaude Opus 5.5 89ac517cab docs: plan for agent profiles in the / menu
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-20 08:49:14 +01:00
FactorandClaude Opus 5.5 2631d86f0e docs: design for agent profiles in the / menu
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-20 08:47:20 +01:00
FactorandOvis Fast f1102524cc fix: the / menu reads .claude sources only for Claude Code
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:36:57 +01:00
FactorandClaude Opus 5.5 3f78fe912d docs: plan for all slash commands in the / menu
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 20:32:01 +01:00
FactorandOvis Fast 56fa39dd18 feat: the / menu scrolls through every match and caches the global catalog
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:30:52 +01:00
FactorandOvis Fast 02f7f2465b feat: the / menu offers user, plugin and all built-in commands
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:29:44 +01:00
FactorandOvis Fast a4c7f25307 fix: the panel layer swallows mouse events meant for it
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:19:32 +01:00
FactorandOvis Fast f379b9470c fix: a click on a panel row does not reach the bar under it
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:18:20 +01:00
FactorandOvis Fast 000df780be style: dashed, dimmed New button in the dock
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 20:15:45 +01:00
FactorandClaude Sonnet 5.5 bb86c74995 feat: New button label instead of the + icon in the dock
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-11-19 17:56:45 +01:00
FactorandClaude Sonnet 5.5 7e23b8a79c feat: clickable star in the history panel, + form for the dock
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-11-19 17:29:28 +01:00
FactorandClaude Opus 5.5 f880f7ef06 docs: preview.png with the composer dock
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 16:23:33 +01:00
FactorandOvis Fast 989fa88345 fix: dock final review — shared state, menu guards, cleanup
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:18:25 +01:00
FactorandClaude Opus 5.5 fa44ec0bf7 docs: composer dock in README and RECIPE
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 16:14:39 +01:00
FactorandOvis Fast 3c65a4f577 fix: dock menu opens on the first right click after a command
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:12:38 +01:00
FactorandOvis Fast 52d2259060 fix: row menu press does not reach the shield
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:09:19 +01:00
FactorandOvis Fast 3292b04989 fix: shield on_mouse_down takes the button
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:07:34 +01:00
FactorandOvis Fast 68fa3677d1 fix: dock menus — row-menu click-through, rename focus, state reset
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:06:37 +01:00
FactorandOvis Fast 76004542ab feat: right-click menus for dock, star and panel rows
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 16:03:09 +01:00
FactorandOvis Fast a404829261 feat: composer dock in the bar (send / insert)
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 15:59:25 +01:00
FactorandOvis Fast 3b457aad1c fix: dock normalize dedupes ids and trims labels
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 15:58:43 +01:00
FactorandOvis Fast 6b1f946d25 feat: dock model and storage (herdr-composer.dock)
Co-Authored-By: Ovis Fast (Claude) <[email protected]>
2026-11-19 15:57:40 +01:00
FactorandClaude Opus 5.5 4bb0e85612 docs: composer dock design, mockup and plan
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 15:56:20 +01:00
20 changed files with 3539 additions and 131 deletions

No files matched your search

+57 -5
View File
@@ -5,6 +5,7 @@ Pasek wiadomości dla agentów w [Herdr](https://herdr.dev). Jedno pole pod term
- drafty per agent, które przetrwają restart, - drafty per agent, które przetrwają restart,
- kolejka czekająca na koniec tury agenta, - kolejka czekająca na koniec tury agenta,
- historia i ulubione, - historia i ulubione,
- dock z przyciskami do często wysyłanych komend (np. `/handoff`),
- podpowiedzi `/` i `@`, - podpowiedzi `/` i `@`,
- jeden sposób dodawania załączników: upuszczenie, przycisk `+`, Ctrl+V. - jeden sposób dodawania załączników: upuszczenie, przycisk `+`, Ctrl+V.
@@ -65,22 +66,73 @@ Usuwa `mods\herdr-composer`, `layouts\herdr-composer.json` i skrót z `keys.json
| `Alt+Enter` | do kolejki jako wstrzymana (wyślesz ręcznie) | | `Alt+Enter` | do kolejki jako wstrzymana (wyślesz ręcznie) |
| `Esc` | zamyka menu lub panel; przy pustym polu przerywa pracującego agenta | | `Esc` | zamyka menu lub panel; przy pustym polu przerywa pracującego agenta |
| `/`, `@` | podpowiedzi komend, skilli i plików; `↑` `↓` wybór, `Enter`/`Tab` wstaw | | `/`, `@` | podpowiedzi komend, skilli i plików; `↑` `↓` wybór, `Enter`/`Tab` wstaw |
| `Ctrl+R` albo 🕘 | panel Historia / Ulubione: `↑` `↓`, `Enter` wstawia w miejscu kursora (bez wysyłania), `Tab` przełącza zakładki, `Ctrl+D` lub prawy klik dodaje do ulubionych, `Esc` lub ✕ zamyka | | `Ctrl+R` albo 🕘 | panel Historia / Ulubione: `↑` `↓`, `Enter` wstawia w miejscu kursora (bez wysyłania), `Tab` przełącza zakładki, `Ctrl+D` dodaje do ulubionych, `Esc` lub ✕ zamyka |
| ☆ | zapisuje bieżący tekst w ulubionych | | ☆ | zapisuje bieżący tekst w ulubionych; prawy klik przypina go do docka |
| dock (przyciski za ☆) | klik wysyła zapisany tekst do agenta (jak Enter, przez kolejkę) albo, w trybie ✎, wstawia go w miejscu kursora; tekst w polu zostaje |
| prawy klik na przycisk docka | Zmień nazwę, Tylko wstawiaj / Wysyłaj od razu, Przesuń w lewo / w prawo, Usuń z docka |
| prawy klik na wiersz panelu | Wstaw, Dodaj do ulubionych / Usuń z ulubionych; w Ulubionych także Przypnij do docka / Odepnij z docka |
| `+`, upuszczenie pliku, `Ctrl+V` obrazu | załącznik: kopiowany do agenta przez `hc put` i dopisywany jako `@ścieżka` | | `+`, upuszczenie pliku, `Ctrl+V` obrazu | załącznik: kopiowany do agenta przez `hc put` i dopisywany jako `@ścieżka` |
**Kolejka:** gdy agent pracuje, `Enter` dodaje wiadomość do kolejki. Po zakończeniu tury pojawia się odliczanie 3 s z przyciskiem Anuluj, a potem wiadomość wychodzi. Stop albo `Esc` wstrzymuje całą kolejkę. Gdy agent czeka na Twoją odpowiedź (`blocked`), `Enter` wysyła ją od razu (`hc send --force`). **Kolejka:** gdy agent pracuje, `Enter` dodaje wiadomość do kolejki. Po zakończeniu tury pojawia się odliczanie 3 s z przyciskiem Anuluj, a potem wiadomość wychodzi. Stop albo `Esc` wstrzymuje całą kolejkę. Gdy agent czeka na Twoją odpowiedź (`blocked`), `Enter` wysyła ją od razu (`hc send --force`).
**Dane:** historia (500 wpisów), ulubione (100), drafty i kolejki zapisują się lokalnie w `~\.config\herdr-app\shared.json` (klucze `herdr-composer.*`). Obrazy ze schowka trafiają do `~\.config\herdr-app\data\herdr-composer\paste\` i są usuwane po 7 dniach. Nic nie jest wysyłane poza ten komputer. **Dock:** wspólny dla wszystkich agentów, do 30 przycisków. Przyciski dodajesz prawym klikiem na wpis w Ulubionych („Przypnij do docka”) albo na ☆ (bieżący tekst). Gdy przycisków jest dużo, dock przewija się w bok.
**Dane:** historia (500 wpisów), ulubione (100), dock (30 przycisków), drafty i kolejki zapisują się lokalnie w `~\.config\herdr-app\shared.json` (klucze `herdr-composer.*`). Obrazy ze schowka trafiają do `~\.config\herdr-app\data\herdr-composer\paste\` i są usuwane po 7 dniach. Nic nie jest wysyłane poza ten komputer.
## Inni agenci
Menu `/` podpowiada komendy według **profilu agenta**. Domyślne profile są dla Claude Code (alias `claude`) i `codex`. Dla innego agenta menu pokazuje komendy, które wysłałeś mu wcześniej (grupa „Z historii”) oraz szary wiersz „Nieznany agent `<klucz>` – dodaj profil w ~/.config/herdr-app/composer-agents.json”. Klucz z tego wiersza wpisz w polu `match`.
Profile dopisujesz w pliku `~\.config\herdr-app\composer-agents.json` (albo `$HERDR_APP_HOME\composer-agents.json`) na komputerze, na którym działa agent. Zmiana pojawia się w menu w ciągu minuty, bez restartu i bez reinstalacji.
```json
{
"agents": [
{
"id": "nazwa-profilu",
"match": ["klucz-agenta"],
"builtins": [{ "key": "model", "desc": "Wybiera model." }],
"sources": [
{ "scope": "project", "path": ".agent/prompts", "pattern": "*.md" },
{ "scope": "home", "path": ".agent/prompts", "pattern": "*/SKILL.md", "prefix": "@" }
]
}
]
}
```
- `id` (wymagany): nazwa profilu. Profil z tym samym `id` co domyślny **zastępuje go w całości**, bez łączenia list.
- `match` (wymagany, niepusta lista): klucze agenta, bez rozróżniania wielkości liter. Najpierw sprawdzane są profile z pliku, potem domyślne.
- `builtins` (opcjonalny): `{ "key", "desc" }`, grupa „Wbudowane”.
- `sources` (opcjonalny): `scope` to `"project"` (względem folderu panelu; grupa „Projekt”) albo `"home"` (względem folderu domowego; grupa „Użytkownik”). `path` jest względna, bez `..`. `pattern` to `"*.md"` (nazwa komendy = nazwa pliku bez `.md`) albo `"*/SKILL.md"` (nazwa skilla z `name:` we frontmatterze, a w projekcie z nazwy folderu). `prefix` (domyślnie `"/"`) to tekst wstawiany przed nazwą. Źródło `{ "scope": "home", "kind": "claude-plugins" }` czyta pluginy Claude Code.
- Brak pliku to norma. Uszkodzony plik jest ignorowany (działają profile domyślne), a menu pokazuje wiersz „`composer-agents.json`: <powód>”.
**Przykład dla kiro-cli: niesprawdzony.** Nie znamy klucza ani komend tego agenta, więc poniższe wartości są tylko ilustracją. Klucz weź z wiersza „Nieznany agent …” na maszynie z kiro.
```json
{
"agents": [
{
"id": "kiro",
"match": ["kiro-cli", "kiro"],
"builtins": [{ "key": "context" }, { "key": "model" }],
"sources": [
{ "scope": "project", "path": ".kiro/prompts", "pattern": "*.md" },
{ "scope": "home", "path": ".kiro/prompts", "pattern": "*.md", "prefix": "@" }
]
}
]
}
```
## Co mod uruchamia i czyta ## Co mod uruchamia i czyta
Agent instalujący paczkę poinformuje o tym przed instalacją. Agent instalujący paczkę poinformuje o tym przed instalacją.
- **`hc`:** `send`, `put`, `get`, `interrupt`, `keys`. Tak mod rozmawia z terminalami agentów. - **`hc`:** `send`, `put`, `get`, `interrupt`, `keys`. Tak mod rozmawia z terminalami agentów.
- **`powershell`:** odczyt schowka, okno wyboru pliku, rozmiary plików, odczyt komend i skilli z `.claude/` projektu. Ścieżki trafiają do skryptów wyłącznie jako Base64. - **`powershell`:** odczyt schowka, okno wyboru pliku, rozmiary plików, odczyt komend i skilli z folderów projektu wskazanych w profilu agenta (dla Claude Code `.claude/`). Ścieżki trafiają do skryptów wyłącznie jako Base64.
- **`git ls-files`** w folderze agenta: podpowiedzi `@`. - **`git ls-files`** w folderze agenta: podpowiedzi `@`.
- **Pliki spoza folderu modu:** pliki, które sam dodajesz jako załączniki, oraz `.claude/commands` i `.claude/skills` projektu. - **Pliki spoza folderu modu:** pliki, które sam dodajesz jako załączniki, foldery komend z profilu agenta (dla Claude Code `.claude/commands`, `.claude/skills` projektu i `~\.claude`) oraz `composer-agents.json` w `~\.config\herdr-app\`.
- **Sieć:** mod nie korzysta z sieci. - **Sieć:** mod nie korzysta z sieci.
## Przejście z ovis-composer ## Przejście z ovis-composer
@@ -0,0 +1,325 @@
<title>Composer Dock</title>
<meta name="claude:viewport-fit-sides" content="cover">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap">
<style>
/* Layout: makieta okna Herdr (terminal + blok composera) po lewej, legenda stanów po prawej; jeden ciemny wygląd jak w aplikacji. */
:root {
color-scheme: dark;
--page: #0c0e12;
--bg: #11141a; /* tło pola tekstowego */
--raised: #181c24; /* karta composera */
--chrome: #222833; /* przyciski */
--hover: #2c3442;
--border: #2f3746;
--fg: #e3e7ee;
--muted: #9aa4b4;
--dim: #5f6878;
--accent: #7aa2f7;
--working: #e0af68;
--ok: #9ece6a;
--danger: #f7768e;
--sans: "Inter", system-ui, sans-serif;
--mono: "JetBrains Mono", ui-monospace, Consolas, monospace;
}
* { box-sizing: border-box; }
body { background: var(--page); color: var(--fg); font-family: var(--sans); font-size: 14px;
padding-block: 24px; padding-left: max(16px, env(safe-area-inset-left, 0px)); padding-right: max(16px, env(safe-area-inset-right, 0px)); }
h1 { font-size: 20px; font-weight: 600; margin: 0 0 4px; text-wrap: balance; }
h2 { font-size: 13px; font-weight: 600; letter-spacing: .06em; text-transform: uppercase; color: var(--muted); margin: 0 0 10px; }
p.lead { color: var(--muted); margin: 0 0 20px; max-width: 70ch; line-height: 1.5; }
.wrap { max-width: 1180px; margin: 0 auto; }
.grid { display: grid; grid-template-columns: minmax(0, 1fr) 340px; gap: 24px; align-items: start; }
@media (max-width: 900px) { .grid { grid-template-columns: minmax(0, 1fr); } }
/* okno Herdr */
.win { border: 1px solid var(--border); border-radius: 10px; overflow: hidden; background: var(--bg); }
.titlebar { display: flex; gap: 8px; align-items: center; padding: 8px 12px; background: var(--raised); border-bottom: 1px solid var(--border); font-size: 12px; color: var(--muted); }
.tab { padding: 3px 10px; border-radius: 6px; }
.tab.on { background: var(--chrome); color: var(--fg); }
.term { font-family: var(--mono); font-size: 12px; line-height: 1.6; color: var(--muted); padding: 12px 14px; height: 190px; overflow: auto; }
.term .me { color: var(--accent); }
.term .ag { color: var(--fg); }
.term .sys { color: var(--dim); }
.composer { padding: 10px; border-top: 1px solid var(--border); background: var(--page); position: relative; }
.card { display: flex; flex-direction: column; gap: 8px; padding: 10px; border-radius: 12px; border: 1px solid var(--border); background: var(--raised); }
textarea { width: 100%; min-height: 56px; resize: none; border: 0; outline: none; border-radius: 8px; padding: 8px 10px; background: var(--bg); color: var(--fg); font: 13px/1.5 var(--sans); }
textarea:focus-visible { box-shadow: 0 0 0 1px var(--accent); }
.bar { display: flex; align-items: center; gap: 8px; min-width: 0; }
.icon { flex: none; width: 28px; height: 28px; border-radius: 999px; border: 0; background: var(--chrome); color: var(--muted); font-size: 14px; cursor: pointer; display: grid; place-items: center; }
.icon:hover, .icon.on { background: var(--hover); color: var(--fg); }
.sep { flex: none; width: 1px; height: 18px; background: var(--border); margin: 0 2px; }
/* dock */
.dock { flex: 1; min-width: 0; display: flex; gap: 6px; overflow-x: auto; scrollbar-width: thin; padding: 2px 0; }
.dbtn { flex: none; height: 28px; max-width: 150px; padding: 0 11px; border-radius: 8px; border: 1px solid transparent; background: var(--chrome); color: var(--fg); font: 500 12px var(--sans); cursor: pointer; display: inline-flex; align-items: center; gap: 6px; white-space: nowrap; }
.dbtn span.l { overflow: hidden; text-overflow: ellipsis; }
.dbtn:hover { background: var(--hover); }
.dbtn:focus-visible { outline: 1px solid var(--accent); }
.dbtn.insert { background: transparent; border: 1px dashed var(--border); color: var(--muted); }
.dbtn.insert:hover { color: var(--fg); border-color: var(--muted); }
.dbtn .g { font-size: 11px; color: var(--dim); }
.dbtn.flash { background: var(--accent); color: #0c0e12; }
.dbtn.sel { outline: 1px solid var(--accent); }
.dbtn input { width: 110px; background: var(--bg); color: var(--fg); border: 0; outline: none; font: 500 12px var(--sans); padding: 2px 4px; border-radius: 4px; }
.empty { color: var(--dim); font-size: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; padding-left: 4px; }
.chip { flex: none; display: inline-flex; align-items: center; gap: 6px; height: 28px; padding: 0 10px; border-radius: 999px; background: var(--chrome); font-size: 12px; color: var(--muted); }
.dot { width: 7px; height: 7px; border-radius: 99px; background: var(--ok); }
.dot.working { background: var(--working); }
.send { flex: none; height: 28px; padding: 0 14px; border-radius: 8px; border: 0; background: var(--accent); color: #0c0e12; font: 600 12px var(--sans); cursor: pointer; }
/* menu kontekstowe */
.menu { position: absolute; z-index: 5; min-width: 210px; background: var(--raised); border: 1px solid var(--border); border-radius: 8px; padding: 4px; box-shadow: 0 8px 24px rgba(0,0,0,.45); }
.menu button { display: flex; width: 100%; justify-content: space-between; gap: 12px; padding: 6px 10px; border: 0; border-radius: 5px; background: transparent; color: var(--fg); font: 13px var(--sans); text-align: left; cursor: pointer; }
.menu button:hover, .menu button:focus-visible { background: var(--hover); outline: none; }
.menu button.danger { color: var(--danger); }
.menu button .k { color: var(--dim); font-size: 12px; }
.menu hr { border: 0; border-top: 1px solid var(--border); margin: 4px 2px; }
/* panel ulubionych */
.panel { display: flex; flex-direction: column; gap: 6px; padding: 10px; border-radius: 12px; border: 1px solid var(--border); background: var(--raised); margin-bottom: 8px; }
.ptabs { display: flex; gap: 6px; align-items: center; }
.ptabs .t { padding: 3px 10px; border-radius: 6px; font-size: 12px; color: var(--muted); }
.ptabs .t.on { background: var(--chrome); color: var(--fg); }
.ptabs .x { margin-left: auto; }
.row { display: flex; justify-content: space-between; gap: 10px; padding: 7px 10px; border-radius: 6px; font-size: 13px; cursor: context-menu; }
.row:hover { background: var(--hover); }
.row .pin { color: var(--accent); font-size: 11px; white-space: nowrap; }
/* prawa kolumna */
.side { display: flex; flex-direction: column; gap: 16px; min-width: 0; }
.box { border: 1px solid var(--border); border-radius: 10px; padding: 14px; background: var(--raised); }
.box ul { margin: 0; padding-left: 18px; line-height: 1.55; color: var(--muted); }
.box li b { color: var(--fg); font-weight: 500; }
.legend { display: flex; flex-direction: column; gap: 10px; }
.legend div { display: flex; gap: 10px; align-items: center; color: var(--muted); font-size: 13px; }
.log { font-family: var(--mono); font-size: 12px; color: var(--muted); min-height: 60px; line-height: 1.6; }
.log .new { color: var(--fg); }
.states { margin-top: 24px; display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 16px; }
.state .card { pointer-events: none; }
.state p { color: var(--muted); font-size: 12px; margin: 8px 2px 0; line-height: 1.5; }
code { font-family: var(--mono); font-size: 12px; color: var(--fg); }
@media (prefers-reduced-motion: no-preference) { .dbtn { transition: background .12s, color .12s; } }
</style>
<div class="wrap">
<h1>Composer Dock</h1>
<p class="lead">Makieta paska przycisków na środku belki composera. Kliknij przycisk w docku, kliknij go prawym przyciskiem albo otwórz 🕘 i przypnij wpis z Ulubionych. Wszystko poniżej to przykładowe dane.</p>
<div class="grid">
<div>
<div class="win">
<div class="titlebar"><span class="tab">Ovis Opus</span><span class="tab on">Ovis Fast</span><span class="tab">shell</span></div>
<div class="term" id="term">
<div class="sys">╭─ Claude Code · herdrMario</div>
<div class="me">› dodaj test migracji kluczy dock</div>
<div class="ag">● Dodałem tests/dock.test.mjs, 6 przypadków, wszystkie zielone.</div>
<div class="sys"> 155 → 161 pass · 0 fail</div>
</div>
<div class="composer" id="composer">
<div class="panel" id="panel" hidden>
<div class="ptabs"><span class="t">Historia</span><span class="t on">Ulubione</span><button class="icon x" id="pclose" aria-label="Zamknij panel">✕</button></div>
<div id="favs"></div>
</div>
<div class="card">
<textarea id="field" aria-label="Wiadomość do agenta" placeholder="Napisz do Ovis Fast…"></textarea>
<div class="bar">
<button class="icon" aria-label="Dodaj plik">+</button>
<button class="icon" id="hist" aria-label="Historia i ulubione">🕘</button>
<button class="icon" id="star" aria-label="Dodaj do ulubionych">☆</button>
<span class="sep"></span>
<div class="dock" id="dock" role="toolbar" aria-label="Dock"></div>
<span class="chip" id="chip"><span class="dot" id="dot"></span><span id="chipt">Ovis Fast · idle</span></span>
<button class="send">Wyślij</button>
</div>
</div>
<div class="menu" id="menu" hidden></div>
</div>
</div>
</div>
<div class="side">
<div class="box">
<h2>Tryby przycisku</h2>
<div class="legend">
<div><button class="dbtn" tabindex="-1">/handoff</button> wysyła od razu (jak Enter)</div>
<div><button class="dbtn insert" tabindex="-1"><span class="g">✎</span>Review @</button> tylko wstawia w miejsce kursora</div>
</div>
</div>
<div class="box">
<h2>Co się stało</h2>
<div class="log" id="log"><div>Kliknij przycisk w docku.</div></div>
<div style="margin-top:10px;display:flex;gap:8px;align-items:center;font-size:12px;color:var(--muted)">
Stan agenta:
<button class="dbtn" id="toggleState" style="height:24px">przełącz idle / working</button>
</div>
</div>
<div class="box">
<h2>Zasady</h2>
<ul>
<li><b>Wysyłanie</b> idzie tą samą drogą co Enter: agent pracuje → kolejka z odliczaniem 3 s, <code>blocked</code> → od razu.</li>
<li><b>Tekst w polu</b> zostaje nietknięty przy przycisku „wysyła od razu”.</li>
<li><b>Dock jest wspólny</b> dla wszystkich agentów, zapis w <code>shared.json</code> pod <code>herdr-composer.dock</code>.</li>
<li><b>Nazwa</b> domyślnie to początek tekstu, do 16 znaków.</li>
<li><b>Za dużo przycisków</b>: dock przewija się poziomo, chip i Wyślij stoją w miejscu.</li>
</ul>
</div>
</div>
</div>
<h2 style="margin-top:28px">Stany do porównania</h2>
<div class="states">
<div class="state">
<div class="card"><div class="bar">
<button class="icon">+</button><button class="icon">🕘</button><button class="icon">☆</button><span class="sep"></span>
<div class="dock"><span class="empty">Prawy klik w Ulubionych → Przypnij do docka</span></div>
<span class="chip"><span class="dot"></span>idle</span><button class="send">Wyślij</button>
</div></div>
<p>Pusty dock: szara podpowiedź zamiast przycisków.</p>
</div>
<div class="state">
<div class="card"><div class="bar">
<button class="icon">+</button><button class="icon">🕘</button><button class="icon">☆</button><span class="sep"></span>
<div class="dock"><button class="dbtn">/handoff</button><button class="dbtn">/clear</button><button class="dbtn insert"><span class="g">✎</span>Review @</button><button class="dbtn">npm test i ra…</button><button class="dbtn">/compact</button></div>
<span class="chip"><span class="dot"></span>idle</span><button class="send">Wyślij</button>
</div></div>
<p>Dużo przycisków: dock przewija się poziomo (kółkiem lub Shift+kółkiem).</p>
</div>
<div class="state">
<div class="card"><div class="bar">
<button class="icon">+</button><button class="icon">🕘</button><button class="icon">☆</button><span class="sep"></span>
<div class="dock"><button class="dbtn sel"><input value="Handoff" aria-label="Nazwa"></button><button class="dbtn">/clear</button></div>
<span class="chip"><span class="dot"></span>idle</span><button class="send">Wyślij</button>
</div></div>
<p>Zmiana nazwy w miejscu: Enter zapisuje, Esc anuluje. Tekst wysyłany się nie zmienia.</p>
</div>
</div>
</div>
<script>
const dockEl = document.getElementById("dock"), menu = document.getElementById("menu"), field = document.getElementById("field");
const logEl = document.getElementById("log"), composer = document.getElementById("composer"), panel = document.getElementById("panel");
let working = false, editing = -1, queue = 0;
let dock = [
{ label: "/handoff", text: "/handoff", mode: "send" },
{ label: "/clear", text: "/clear", mode: "send" },
{ label: "Review @", text: "Zrób review pliku @", mode: "insert" },
];
const favorites = [
"/handoff", "/clear", "Zrób review pliku @", "npm test i raport po polsku", "/compact",
];
const short = (s) => (s.length > 16 ? s.slice(0, 14) + "…" : s);
function log(msg) {
[...logEl.children].forEach((d) => d.classList.remove("new"));
const d = document.createElement("div"); d.className = "new"; d.textContent = msg;
logEl.prepend(d);
while (logEl.children.length > 4) logEl.lastChild.remove();
}
function render() {
dockEl.innerHTML = "";
if (!dock.length) {
const e = document.createElement("span"); e.className = "empty";
e.textContent = "Prawy klik w Ulubionych → Przypnij do docka"; dockEl.append(e);
}
dock.forEach((b, i) => {
const el = document.createElement("button");
el.className = "dbtn" + (b.mode === "insert" ? " insert" : "") + (editing === i ? " sel" : "");
el.title = b.text + (b.mode === "insert" ? " (wstawia)" : " (wysyła)");
if (editing === i) {
const inp = document.createElement("input"); inp.id = "rename"; inp.value = b.label; inp.setAttribute("aria-label", "Nazwa przycisku");
inp.addEventListener("keydown", (ev) => {
if (ev.key === "Enter") { b.label = inp.value.trim() || short(b.text); editing = -1; render(); log(`Zmieniono nazwę na „${b.label}”`); }
if (ev.key === "Escape") { editing = -1; render(); }
});
inp.addEventListener("blur", () => { if (editing === i) { editing = -1; render(); } });
el.append(inp); dockEl.append(el); setTimeout(() => { inp.focus(); inp.select(); }); return;
}
if (b.mode === "insert") { const g = document.createElement("span"); g.className = "g"; g.textContent = "✎"; el.append(g); }
const l = document.createElement("span"); l.className = "l"; l.textContent = b.label; el.append(l);
el.addEventListener("click", () => press(b, el));
el.addEventListener("contextmenu", (ev) => { ev.preventDefault(); openMenu(ev, dockMenu(i)); });
dockEl.append(el);
});
}
function press(b, el) {
el.classList.add("flash"); setTimeout(() => el.classList.remove("flash"), 180);
if (b.mode === "insert") {
const s = field.selectionStart ?? field.value.length, e = field.selectionEnd ?? s;
field.value = field.value.slice(0, s) + b.text + field.value.slice(e);
field.focus(); field.selectionStart = field.selectionEnd = s + b.text.length;
log(`Wstawiono „${b.text}” w miejscu kursora`); return;
}
if (working) { queue++; log(`Agent pracuje: „${b.text}” w kolejce (${queue}), wyjdzie po turze`); return; }
log(`hc send t5 -- ${b.text} → Ovis Fast`);
const t = document.getElementById("term"); const d = document.createElement("div"); d.className = "me"; d.textContent = "› " + b.text; t.append(d); t.scrollTop = t.scrollHeight;
}
function dockMenu(i) {
const b = dock[i];
return [
["Zmień nazwę", "F2", () => { editing = i; render(); }],
[b.mode === "send" ? "Tylko wstawiaj" : "Wysyłaj od razu", "", () => { b.mode = b.mode === "send" ? "insert" : "send"; render(); log(`„${b.label}”: ${b.mode === "send" ? "wysyła od razu" : "tylko wstawia"}`); }],
["Przesuń w lewo", "", () => { if (i > 0) { [dock[i - 1], dock[i]] = [dock[i], dock[i - 1]]; render(); } }, i === 0],
["Przesuń w prawo", "", () => { if (i < dock.length - 1) { [dock[i + 1], dock[i]] = [dock[i], dock[i + 1]]; render(); } }, i === dock.length - 1],
"hr",
["Usuń z docka", "", () => { log(`Usunięto „${b.label}”`); dock.splice(i, 1); render(); }, false, "danger"],
];
}
function openMenu(ev, items) {
menu.innerHTML = "";
items.forEach((it) => {
if (it === "hr") { menu.append(document.createElement("hr")); return; }
const [label, key, fn, disabled, cls] = it;
const b = document.createElement("button"); if (cls) b.className = cls;
b.innerHTML = `<span></span><span class="k"></span>`; b.firstChild.textContent = label; b.lastChild.textContent = key;
if (disabled) b.style.opacity = .4;
b.addEventListener("click", () => { closeMenu(); if (!disabled) fn(); });
menu.append(b);
});
const r = composer.getBoundingClientRect();
menu.hidden = false;
const x = Math.min(ev.clientX - r.left, r.width - menu.offsetWidth - 8);
menu.style.left = Math.max(8, x) + "px";
menu.style.top = (ev.clientY - r.top - menu.offsetHeight - 6) + "px";
menu.querySelector("button").focus();
}
function closeMenu() { menu.hidden = true; }
document.addEventListener("click", (e) => { if (!menu.contains(e.target)) closeMenu(); });
document.addEventListener("keydown", (e) => { if (e.key === "Escape") { closeMenu(); } });
function renderFavs() {
const box = document.getElementById("favs"); box.innerHTML = "";
favorites.forEach((f) => {
const pinned = dock.some((b) => b.text === f);
const r = document.createElement("div"); r.className = "row";
r.innerHTML = `<span></span><span class="pin"></span>`; r.firstChild.textContent = f; r.lastChild.textContent = pinned ? "w docku" : "";
r.addEventListener("contextmenu", (ev) => {
ev.preventDefault();
openMenu(ev, [
["Wstaw", "Enter", () => { field.value += f; }],
pinned ? ["Odepnij z docka", "", () => { dock = dock.filter((b) => b.text !== f); render(); renderFavs(); log(`Odpięto „${f}”`); }]
: ["Przypnij do docka", "", () => { dock.push({ label: short(f), text: f, mode: "send" }); render(); renderFavs(); log(`Przypięto „${short(f)}” na końcu docka`); }],
"hr",
["Usuń z ulubionych", "Ctrl+D", () => {}, true, "danger"],
]);
});
box.append(r);
});
}
document.getElementById("hist").addEventListener("click", () => { panel.hidden = !panel.hidden; renderFavs(); });
document.getElementById("pclose").addEventListener("click", () => { panel.hidden = true; });
document.getElementById("star").addEventListener("contextmenu", (ev) => {
ev.preventDefault();
const t = field.value.trim();
openMenu(ev, [["Przypnij bieżący tekst do docka", "", () => { dock.push({ label: short(t), text: t, mode: "send" }); render(); log(`Przypięto „${short(t)}”`); }, !t]]);
});
document.getElementById("toggleState").addEventListener("click", () => {
working = !working; if (!working && queue) { log(`Tura skończona: odliczanie 3 s, potem ${queue} z kolejki`); queue = 0; }
document.getElementById("dot").className = "dot" + (working ? " working" : "");
document.getElementById("chipt").textContent = "Ovis Fast · " + (working ? "working" : "idle");
});
render();
</script>
@@ -0,0 +1,149 @@
# Wszystkie komendy w menu `/` — plan implementacji
**Cel:** po wpisaniu `/` composer pokazuje wszystkie komendy Claude Code, czyli:
- pełną listę wbudowanych,
- komendy i skille projektu,
- globalne komendy i skille użytkownika (`~/.claude`),
- komendy i skille włączonych pluginów.
Menu pokazuje wszystkie trafienia jako przewijaną listę.
**Zaakceptowane przez użytkownika (2026-11-19):**
- pełna statyczna lista wbudowanych;
- globalne `~/.claude/commands` i `~/.claude/skills`;
- pluginy włączone w `~/.claude/settings.json`, nazwy `plugin:nazwa`;
- menu przewijane, bez ucinania do 20;
- katalog globalny czytany raz i odświeżany w tle, nie przy każdym klawiszu.
## Ograniczenia globalne
- Nie zmieniamy Herdr ani jego plików. Pracujemy tylko na gałęzi `feature/composer-dock`. Bez push.
- Testowalna logika jest w `catalog.js` (czysty moduł; `exec` i odczyt pliku wstrzyknięte). GPUI jest tylko w `main.js`.
- Ścieżki w skryptach PowerShell przekazujemy wyłącznie przez `decode()` z `powershell.js` (Base64), jak w `readScript`.
- Błąd odczytu katalogu globalnego nie psuje menu. Wbudowane i projekt dalej się pokazują, a błąd idzie do `onReadError`.
- Opisy wbudowanych komend są po polsku.
## Fakty o środowisku (sprawdzone)
- `herdr` eksportuje:
- `home()`: katalog domowy;
- `readTextFile(path)`: UTF-8 do 1 MiB albo `null`, poza wątkiem UI, bez exec;
- `exec(cmd,args,{cwd,timeout})`.
- `~/.claude/settings.json` zawiera `enabledPlugins`, np. `{ "superpowers@claude-plugins-official": true, ... }`. Nazwa pluginu to część przed `@`.
- `~/.claude/plugins/installed_plugins.json` ma postać `{ "version": 2, "plugins": { "<id>": [ { "installPath": "C:\\...\\superpowers\\7.0.2", ... } ] } }`. Bierzemy pierwszy wpis z `installPath`.
- `<installPath>/.claude-plugin/plugin.json` może mieć pola `skills` i `commands`:
- tablica ścieżek względnych to katalogi skilli (każdy z `SKILL.md`) albo pliki `.md` komend;
- string to katalog do przejrzenia jak domyślny;
- brak pola oznacza domyślne `skills/*/SKILL.md` i `commands/*.md`.
- Przykład: mattpocock-skills ma `"skills": ["./skills/engineering/tdd", ...]`.
- Frontmatter `SKILL.md`:
- `name:` (gdy jest) wygrywa z nazwą katalogu;
- `description:` to opis;
- `user-invocable: false` znaczy: nie pokazywać w menu.
- Grupy w `suggest.js`: `GROUPS = [Wbudowane, Projekt, Użytkownik, Terminal]`. Dodajemy `GROUP_PLUGIN = "Pluginy"` po `Użytkownik`.
## Task 1 — katalog (`catalog.js`, `suggest.js`, testy)
**Interfejsy:**
- `BUILTINS["claude-code"]`: pełna lista (poniżej), alfabetycznie. Komentarz nad listą mówi, że lista jest ręczna i że przy nowej wersji Claude Code trzeba ją uzupełnić.
- `export const GROUP_PLUGIN = "Pluginy"` w `suggest.js`, dopisana do `GROUPS` po `GROUP_USER`.
- `export async function globalCommands(home, exec, readText, options = {})` zwraca `Promise<Item[]>`:
1. Odczytuje `settings.json` oraz `installed_plugins.json`, a dla każdego włączonego pluginu jego `plugin.json` (przez `readText`; brak pliku albo zły JSON to pusta lista z tego źródła, bez wyjątku).
2. Zbiera katalogi i pliki do przejrzenia:
- użytkownik: `~/.claude/commands/*.md`, `~/.claude/skills/*/SKILL.md`;
- pluginy według reguł `plugin.json` wyżej.
3. Jednym wywołaniem `exec` (PowerShell, a `sh` jako zapas, wzór `listProjectFiles`) wypisuje istniejące pliki. Wszystkie wzorce trafiają do skryptu przez Base64.
4. Każdy plik czyta przez `readText`. Pomija `user-invocable: false`.
5. Item:
- użytkownik: `{key, desc, group: GROUP_USER, insert: "/key "}`;
- plugin: `key = "<plugin>:<name>"`, `group: GROUP_PLUGIN`.
6. Błąd listowania to wyjątek, chyba że jest `options.onReadError`: wtedy go wywołuje i zwraca to, co się da.
- `commands(cwd, exec, options)` przyjmuje `options.global` (Item[], gotowe z cache). Kolejność: builtins, project, global, snippets. Duplikaty `key` usuwa: pierwszy wygrywa.
**Lista wbudowanych `claude-code`:** zostaw obecne 6 i dodaj resztę. `key`, potem polski opis:
- `add-dir`: Dodaje katalog roboczy.
- `agents`: Zarządza subagentami.
- `bashes`: Pokazuje zadania w tle.
- `bug`: Zgłasza błąd Claude Code.
- `clear`: Czyści historię rozmowy.
- `code-review`: Przegląd zmian pod kątem błędów.
- `compact`: Zwija historię do podsumowania.
- `config`: Otwiera ustawienia.
- `context`: Pokazuje zużycie kontekstu.
- `cost`: Pokazuje koszt i zużycie tokenów.
- `doctor`: Sprawdza instalację Claude Code.
- `exit`: Kończy sesję.
- `export`: Eksportuje rozmowę.
- `fast`: Przełącza tryb szybki.
- `feedback`: Wysyła opinię o Claude Code.
- `fewer-permission-prompts`: Dodaje bezpieczne komendy do listy dozwolonych.
- `help`: Pomoc.
- `hooks`: Zarządza hookami.
- `ide`: Łączy z IDE.
- `init`: Tworzy CLAUDE.md dla projektu.
- `install-github-app`: Instaluje aplikację GitHub.
- `keybindings`: Ustawia skróty klawiszowe.
- `login`: Logowanie.
- `logout`: Wylogowanie.
- `loop`: Uruchamia polecenie cyklicznie.
- `mcp`: Zarządza serwerami MCP.
- `memory`: Edytuje pliki pamięci.
- `model`: Wybiera model.
- `output-style`: Ustawia styl odpowiedzi.
- `permissions`: Ustawia uprawnienia narzędzi.
- `plugin`: Zarządza pluginami.
- `pr-comments`: Pokazuje komentarze PR.
- `privacy-settings`: Ustawienia prywatności.
- `release-notes`: Pokazuje informacje o wydaniu.
- `resume`: Wznawia wcześniejszą sesję.
- `review`: Przegląd pull requesta.
- `rewind`: Cofa rozmowę lub kod.
- `schedule`: Planuje zadania w chmurze.
- `security-review`: Przegląd bezpieczeństwa zmian.
- `simplify`: Upraszcza zmieniony kod.
- `status`: Pokazuje stan sesji.
- `statusline`: Ustawia linię statusu.
- `terminal-setup`: Konfiguruje terminal.
- `todos`: Pokazuje listę zadań.
- `upgrade`: Zmienia plan.
- `usage`: Pokazuje limity użycia.
- `vim`: Przełącza tryb vim.
- `workflows`: Pokazuje przebieg workflow.
**Testy** (`tests/catalog*.test.mjs` albo istniejący plik testów katalogu; fałszywe `exec` i `readText`):
- `GROUPS` zawiera `"Pluginy"` po `"Użytkownik"`.
- Builtiny `claude-code` zawierają co najmniej `context`, `help`, `mcp`, `rewind` i `clear`; klucze są unikalne.
- `globalCommands`:
- plugin włączony daje `superpowers:brainstorming`;
- plugin wyłączony (`false`) albo nieobecny w `enabledPlugins` nic nie daje;
- `plugin.json` z tablicą `skills` bierze tylko wymienione katalogi;
- `user-invocable: false` jest pominięty;
- `name:` z frontmattera wygrywa z nazwą katalogu;
- komenda użytkownika `~/.claude/commands/handoff.md` daje `handoff` w grupie `Użytkownik`;
- brak `settings.json` daje tylko pozycje użytkownika, bez wyjątku;
- błąd listowania z `onReadError` wywołuje handler i zwraca resztę.
- `commands` z `options.global` usuwa duplikat `key` (pierwszy wygrywa).
Commit: `feat: the / menu offers user, plugin and all built-in commands`.
## Task 2 — menu i cache (`main.js`)
- Cache katalogu globalnego:
- `this.globalCommands = null`, `this.globalLoadedAt = 0`, `this.globalLoading = false`;
- przy otwarciu menu `/`: brak cache albo cache starszy niż 60 s uruchamia `refreshGlobal(cx)` (jedno naraz, w tle);
- `loadSuggestions` używa tego, co już jest (`options.global: this.globalCommands ?? []`);
- po zakończeniu odświeżenia, gdy menu `/` jest otwarte, przelicz je (`loadSuggestions` dla bieżącego tokenu);
- w `checking()` nie odpalaj.
- Menu:
- usuń ucinanie do `MENU_LIMIT` i wiersz „…i jeszcze N”; renderuj wszystkie trafienia;
- `ScrollHandle.new()` z `gpui-kit` w `init()`, `.track_scroll(handle)` na `composer-menu-list`;
- przy zmianie `menu.index` (strzałki) wołaj `handle.scroll_to_item(index)` (licz z wierszem błędu/pustki, jeśli jest dzieckiem przed pozycjami);
- wysokość menu bez zmian.
- Nagłówki grup / kolejność: `merge(groupItems(...))` z nową grupą działa bez zmian (sprawdź).
Commit: `feat: the / menu scrolls through every match and caches the global catalog`.
## Review Focus
1. Brak `~/.claude/settings.json` albo `installed_plugins.json`, uszkodzony JSON: menu dalej działa.
2. Ścieżki ze spacjami i polskimi znakami (`D:\Development\workspace - Mariusz`) w listowaniu.
3. Szybkie pisanie po `/`: żadnego exec na każdy klawisz dla katalogu globalnego.
4. Strzałka w dół za widoczny obszar: zaznaczenie widoczne (scroll).
5. Plugin z `skills` jako tablicą (mattpocock-skills) i jako brak pola (superpowers).
@@ -0,0 +1,123 @@
# Composer Dock Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Konfigurowalny dock przycisków w belce herdr-composer: klik wysyła lub wstawia zapisany tekst, a zarządzanie odbywa się z menu pod prawym klikiem.
**Architecture:** Czysta logika docka i menu w nowym `dock.js`, zapis w `storage.js` (`herdr-composer.dock`). `main.js` rysuje dock i menu, a wysyłanie przekazuje do istniejącego `finish()` (kolejka, `--force`, strażnik agenta), z pominięciem pola tekstowego.
**Tech Stack:** mod Herdr (ES modules, `gpui-kit`), `node --test`.
**Spec:** `docs/superpowers/specs/2026-11-19-composer-dock-design.md` · makieta `docs/superpowers/mockups/herdr-composer-dock.html`
## Global Constraints
- Bez rekompilacji Herdr i bez zmian w plikach dostarczanych z Herdr. Zmiany tylko w `herdr/herdr-composer/`, `tests/`, `README.md` i `docs/`.
- Kod modu: `herdr/herdr-composer/mods/herdr-composer/`. Moduły czyste (`dock.js`, `storage.js`) nie importują `gpui-kit`, `gpui-base` ani `herdr`.
- Klucz zapisu `herdr-composer.dock`, bez odczytu `ovis-composer.*` (nowa funkcja, brak migracji).
- Limit 30 przycisków. Nazwa domyślna ma najwyżej 16 znaków (15 + `…`), białe znaki są zwinięte do jednej spacji.
- Teksty UI po polsku, dosłownie: „Przypnij do docka”, „Odepnij z docka”, „Przypnij bieżący tekst do docka”, „Odepnij bieżący tekst z docka”, „Zmień nazwę”, „Tylko wstawiaj”, „Wysyłaj od razu”, „Przesuń w lewo”, „Przesuń w prawo”, „Usuń z docka”, „Wstaw”, „Dodaj do ulubionych”, „Usuń z ulubionych”, „Prawy klik w Ulubionych → Przypnij do docka”.
- Dock ma wysokość 28 px i nie może zwiększać wysokości bloku composera (auto-fit).
- Skróty klawiszowe modu zostają w kontekście `herdr-composer > Input`. Nie dodajemy nowych globalnych.
- Testy: `npm test` (dziś 155 pass) musi być zielone po każdym zadaniu.
- Po zmianie modu: `install.cmd` (kopia do `~/.config/herdr-app/mods/herdr-composer`), `herdr-app status` → `"errors": []`.
## Review Focus
- Klik przycisku `send`, gdy w polu jest niewysłany szkic: szkic i załączniki zostają nietknięte, a wysyła się tylko tekst przycisku.
- Klik `send`, gdy agent `working` albo kolejka niepusta: wiadomość trafia do kolejki, a nie wychodzi od razu. Agent `blocked` dostaje ją od razu z `--force`.
- Klik tuż po przełączeniu agenta (okno 500 ms): `syncOk` blokuje wysyłkę i pokazuje komunikat, bez wysłania do złego agenta.
- Uszkodzony albo ręcznie zmieniony `herdr-composer.dock` w `shared.json` (nie-tablica, brak pól, duplikaty, ponad 30): dock ładuje to, co poprawne, i nie wywraca modu.
- Edycja nazwy w miejscu: Esc anuluje tylko edycję i nie przerywa agenta. Enter zapisuje i niczego nie wysyła.
---
### Task 1: `dock.js` + zapis w `storage.js`
**Files:**
- Create: `herdr/herdr-composer/mods/herdr-composer/dock.js`
- Modify: `herdr/herdr-composer/mods/herdr-composer/storage.js` (`KEYS`, nowe `loadDock`/`saveDock`)
- Test: `tests/dock.test.mjs`, `tests/storage.test.mjs`
**Interfaces — Produces:**
- `DockButton = { id: string, label: string, text: string, mode: "send" | "insert" }`
- `MenuItem = { command: string, label: string, disabled?: boolean, danger?: boolean }`
- `DOCK_LIMIT = 30`, `LABEL_MAX = 16`
- `defaultLabel(text: string): string`
- `normalize(raw: unknown): DockButton[]`: przepuszcza tylko poprawne wpisy (`id` i `text` niepuste, `mode` z listy). Pusty `label` zamienia na `defaultLabel(text)`. Odrzuca duplikaty `text` (porównanie po `trim()`, pierwszy wygrywa) i obcina do 30.
- `isPinned(dock, text): boolean` (porównanie po `trim()`).
- `pin(dock, text, id): DockButton[]`: dodaje na końcu `{id, label: defaultLabel(text), text: text.trim(), mode: "send"}`. Zwraca ten sam dock, gdy tekst jest pusty, już przypięty albo osiągnięto limit.
- `unpin(dock, text)`, `remove(dock, id)`, `move(dock, id, step: -1 | 1)` (na krawędzi bez zmian), `rename(dock, id, label)` (pusty po `trim()` → `defaultLabel(text)`), `toggleMode(dock, id)`: każda zwraca nową tablicę i nie mutuje wejścia.
- `dockAction(button, { hasAgent: boolean }): "send" | "insert" | "none"`
- `dockMenu(dock, id): MenuItem[]`: komendy po kolei: `rename`, `mode` (etykieta „Tylko wstawiaj” przy `send`, „Wysyłaj od razu” przy `insert`), `left` (disabled na pierwszym), `right` (disabled na ostatnim), `remove` (`danger: true`).
- `rowMenu({ tab: "history" | "favorites", favorite: boolean, pinned: boolean }): MenuItem[]`: `insert` „Wstaw”. Potem w zakładce `favorites` `pin` („Przypnij do docka” / „Odepnij z docka”). Na końcu `favorite` („Dodaj do ulubionych” / „Usuń z ulubionych”, `danger` przy usuwaniu).
- `starMenu({ text: string, pinned: boolean }): MenuItem[]`: jedna pozycja `pin` („Przypnij bieżący tekst do docka” / „Odepnij bieżący tekst z docka”), `disabled`, gdy `text.trim()` jest pusty.
- `storage.js`: `KEYS.dock = "herdr-composer.dock"`, `loadDock(store): DockButton[]` (przez `normalize`, bez fallbacku `ovis-composer.`), `saveDock(store, items): void` (zapisuje `normalize(items)`).
- [ ] **Step 1: Napisz testy, które padają** w `tests/dock.test.mjs`. Przypadki z wartościami:
- `defaultLabel("/handoff") === "/handoff"`
- `defaultLabel("npm test i raport po polsku") === "npm test i rapo…"` (15 + `…`)
- `defaultLabel(" a\n b ") === "a b"`
- `normalize("x")` daje `[]`
- `normalize([{id:"1",text:"a",mode:"send",label:""}, {id:"2",text:" a ",mode:"send",label:"x"}, {id:"3",text:"b",mode:"zly"}])` → jeden wpis `{id:"1",label:"a",text:"a",mode:"send"}`
- `normalize` z 35 poprawnymi wpisami → długość 30
- `pin([], " /clear ", "9")` → `[{id:"9",label:"/clear",text:"/clear",mode:"send"}]`; `pin` tego samego tekstu drugi raz → bez zmian; `pin(d, " ", "x")` → bez zmian; `pin` przy 30 → bez zmian
- `move(d, firstId, -1)` → bez zmian; `move(d, firstId, 1)` zamienia pierwszy z drugim; wejście nie jest zmutowane (`Object.isFrozen`-owa kopia albo porównanie z kopią)
- `rename(d, id, " ")` → `label === defaultLabel(text)`; `toggleMode` dwa razy → `"send"`
- `dockAction({mode:"insert"}, {hasAgent:true}) === "insert"`; `dockAction({mode:"send"}, {hasAgent:false}) === "none"`
- `dockMenu`: komendy `["rename","mode","left","right","remove"]`; dla pierwszego `left.disabled === true`; etykiety trybu jak wyżej
- `rowMenu({tab:"history",favorite:false,pinned:false})` → komendy `["insert","favorite"]`; `rowMenu({tab:"favorites",favorite:true,pinned:true})` → `["insert","pin","favorite"]` z etykietą „Odepnij z docka”
- `starMenu({text:"",pinned:false})[0].disabled === true`
W `tests/storage.test.mjs`: `saveDock` → `loadDock` daje to samo; `loadDock` przy wartości pod `ovis-composer.dock` i braku nowej → `[]`; śmieci pod kluczem → `[]`.
- [ ] **Step 2:** `npm test`: nowe testy padają (brak modułu lub funkcji).
- [ ] **Step 3:** Zaimplementuj `dock.js` i zmiany w `storage.js` (dla odczytu wzoruj się na `readList`, ale bez `loadMigrating`).
- [ ] **Step 4:** `npm test`: wszystko zielone.
- [ ] **Step 5: Commit** `feat: dock model and storage (herdr-composer.dock)`
### Task 2: Dock w belce: rysowanie i klik
**Files:**
- Modify: `herdr/herdr-composer/mods/herdr-composer/main.js` (`init`: `this.dock = loadDock(store)`; `renderCard`; nowe `renderDock`, `dockPress`)
**Interfaces — Consumes:** Task 1 (`loadDock`, `saveDock`, `dockAction`, `DockButton`), istniejące `syncOk`, `target`, `finish(agent, message, cx, mode)`, `overLimit`, `textarea.replace`, `syncFieldAfterReplace`, `notice`.
- [ ] **Step 1:** W `renderCard` wstaw za ☆ separator (1×18 px, `t.border`). Zamiast `div().flex_1()` wstaw `renderDock(t, active)`: `h_flex().flex_1().min_w(0).h(28).gap(6).overflow_x_scroll()` (`id("composer-dock")`). Pusty dock pokazuje podpowiedź w kolorze `t.dim`, rozmiar 12.
- [ ] **Step 2:** Przycisk `id("dock-"+b.id)`, wysokość 28, `px(11)`, `rounded(8)`, tekst 12, `flex_none`, maks. szerokość 150 z ucięciem. `send`: `bg(t.chrome)`, `text_color(t.foreground)`. `insert`: brak tła, ramka 1 px `t.border` (przerywana, jeśli API pozwala; jeśli nie, pełna) i prefiks `✎ ` w `t.dim`. Gdy `!active`: `text_color(t.dim)`, bez `cursor_pointer` i bez akcji. Tooltip z pełnym `text`, jeśli `gpui-kit` ma `tooltip`; jeśli nie, pomiń.
- [ ] **Step 3:** `dockPress(button, cx)`:
- `insert`: `this.textarea.replace(button.text)`, `syncFieldAfterReplace()`, notice „Wstawiono w miejscu kursora — nic nie zostało wysłane.”
- `send`: `syncOk` (przy błędzie ten sam komunikat co w `submit`, bez „Zostaje w szkicu”), potem `target()`, `overLimit(button.text)`, a na końcu `this.finish(agent, button.text.trim(), cx)`. Nie wolno wołać `clearField`, `submit` ani ruszać załączników.
- [ ] **Step 4:** `npm test` zielone, `install.cmd`, `herdr-app check` i `herdr-app status` bez błędów. Testu w GUI wykonawca nie robi (Task 4, Opus).
- [ ] **Step 5: Commit** `feat: composer dock in the bar (send / insert)`
### Task 3: Menu pod prawym klikiem (dock, ☆, wiersze panelu)
**Files:**
- Modify: `main.js` (menu i obsługa komend), `panel.js` (secondary click woła `on.rowMenu(key, event, cx)` zamiast `on.toggle`)
**Interfaces — Consumes:** `dockMenu`, `rowMenu`, `starMenu`, `pin`, `unpin`, `remove`, `move`, `rename`, `toggleMode`, `isPinned`, `saveDock`, istniejące `toggleFavoriteText`, `panelPickKey`, `isFavorite`, `newId`.
- [ ] **Step 1: Jeden renderer menu** `renderContextMenu(t, items, onCommand)`: `v_flex`, min. szerokość 210, `bg(t.raised)`, ramka `t.border`, `rounded(8)`, `p(4)`. Pozycja `danger` w kolorze błędu z motywu, `disabled` przygaszona i bez akcji. Stan `this.contextMenu = { kind: "dock" | "row" | "star", id | key, items } | null`. Esc z fokusem w polu zamyka najpierw menu (dopisz w `runAction("escape")` przed panelem i przerwaniem agenta). Klik poza menu zamyka (`on_mouse_down_out`).
- [ ] **Step 2: Kotwiczenie.** Przycisk docka i ☆: `Popover` z `.mouse_button("right")`, kontrolowany (`open(this.contextMenu?.kind===... && id===...)`, `on_open_change`). Wiersz panelu (lista wirtualna, `on_item_secondary_click`): menu jako `Popup` zakotwiczony do kontenera panelu (`anchor("top_right")`). Ruling: jeśli `Popover` nie zadziała z prawym przyciskiem w GUI, użyj `Popup` zakotwiczonego do całego docka, z tym samym rendererem.
- [ ] **Step 3: Komendy.**
- dock: `rename` ustawia `this.renaming = id` i rysuje przycisk jako mały `Input` (osobny stan input, szer. 110, wstępnie pełna nazwa). Enter wywołuje `rename` + `saveDock`. Esc i blur anulują. Kontekst `herdr-composer > Input` obejmuje też ten input, więc w `runAction` przy `this.renaming` klawisze `escape`, `up`, `down` i `tab` są obsługiwane jako edycja nazwy, a nie composera.
- dock: `mode` wywołuje `toggleMode`, `left`/`right` wywołują `move`, `remove` wywołuje `remove`. Każda kończy się `saveDock` i `cx.notify()`.
- wiersz: `insert` woła `panelPickKey`, `favorite` woła `toggleFavoriteText`, `pin` woła `pin(dock, text, this.newId())` albo `unpin`.
- ☆: `pin`/`unpin` bieżącego `this.value`.
- Lewy klik ☆ bez zmian.
- [ ] **Step 4: `Ctrl+D` w panelu** dalej przełącza ulubione od razu (sprawdź, że `panelKey` tego nie zmienia).
- [ ] **Step 5:** `npm test`, `install.cmd`, `herdr-app check` i `status` bez błędów.
- [ ] **Step 6: Commit** `feat: right-click menus for dock, star and panel rows`
### Task 4 (Opus): weryfikacja w GUI, dokumentacja
- [ ] Test GUI (SendKeys i `herdr-app shot`, wykonuje Opus):
- przypięcie z Ulubionych oraz z ☆;
- klik `send` przy `idle`: dociera do agenta, a szkic zostaje;
- klik przy `working`: trafia do kolejki;
- tryb `insert`: tekst w miejscu kursora;
- zmiana nazwy Enter/Esc;
- przesuwanie i usuwanie;
- przepełnienie (ponad 8 przycisków), przewijanie;
- brak agenta: wyszarzone;
- restart modu (`install.cmd`): dock przetrwał.
- [ ] README: wiersz w tabeli Użycie („dock”) i akapit w „Dane” (`herdr-composer.dock`). RECIPE.md: punkt w „How it behaves”. `preview.png`: nowy zrzut z dockiem.
- [ ] Commit `docs: composer dock in README, RECIPE and preview`
@@ -0,0 +1,184 @@
# Profile agentów dla menu `/` — plan implementacji
> **Dla wykonawcy (Ovis Fast):** zadania wykonuj po kolei, każde osobnym commitem. Kroki mają checkboxy (`- [ ]`).
**Cel:** menu `/` podpowiada komendy dowolnego agenta. Wiedza o agencie pochodzi z profilu: domyślnego w kodzie albo z pliku `composer-agents.json` użytkownika. Do tego dochodzą komendy wysłane wcześniej do tego agenta, wzięte z historii.
**Architektura:**
- Nowy czysty moduł `profiles.js`: domyślne profile, parsowanie i walidacja pliku, wybór profilu dla `agentName`.
- `catalog.js` przestaje znać Claude Code: czyta źródła, które daje profil, a komendy z historii buduje osobną funkcją.
- `main.js` w tle trzyma plik profili i cache źródeł `home` per `id` profilu, a pod pozycjami menu pokazuje wiersze informacyjne.
**Stack:** JS (ESM), GPUI z `gpui-kit`, testy `node --test` (`npm test`).
**Spec:** `docs/superpowers/specs/2026-11-20-agent-profiles-design.md`. Przeczytaj cały plik przed startem.
## Ograniczenia globalne
- Nie zmieniamy Herdr ani jego plików. Pracujemy tylko na gałęzi `feature/composer-dock`. Bez push.
- Logika testowalna siedzi w czystych modułach (`profiles.js`, `catalog.js`; `exec` i `readText` wstrzyknięte). GPUI jest tylko w `main.js`.
- Ścieżki do skryptów PowerShell trafiają wyłącznie przez `decode()` z `powershell.js` (Base64).
- Menu `/` dla Claude Code (bez historii) daje **identyczną** listę jak przed zmianą: te same `key`, `group`, `insert`, `desc` i kolejność.
- Plik: `[appHome(), "composer-agents.json"].join("\\")`. Brak pliku jest normalny i nie jest błędem.
- TTL odświeżania pliku i źródeł `home`: 60 s (obecne `GLOBAL_TTL_MS`).
- Teksty dla użytkownika dosłownie:
- `GROUP_HISTORY = "Z historii"`;
- nieznany agent: ``Nieznany agent `<nazwa>` – dodaj profil w ~/.config/herdr-app/composer-agents.json`` (gdzie `<nazwa>` to `agentName`);
- problem z plikiem: `` `composer-agents.json`: <powód> ``.
## Review Focus
1. `agentName` w innej wielkości liter niż `match` (np. `Kiro-CLI`): profil ma pasować. Test w Task 1.
2. Plik z BOM, CRLF albo komentarzem-śmieciem: BOM jest usuwany, zły JSON daje domyślne profile i powód. Test w Task 1.
3. Wpis historii zaczynający się ścieżką (`/c/Users/x`), samym `/` albo `/ cos` nie jest komendą. Test w Task 2.
4. Dwa panele z różnymi agentami: menu codex nie pokazuje komend `~/.claude`, bo cache jest per `id`. Test cache w Task 3 (czysta funkcja).
5. Profil z pliku nadpisujący `claude-code` bez `claude-plugins` nie pokazuje pluginów, a ścieżka `..` lub bezwzględna jest odrzucana. Test w Task 1.
---
### Task 1: `profiles.js`, czyli domyślne profile, parsowanie i wybór
**Pliki:**
- Utwórz: `herdr/herdr-composer/mods/herdr-composer/profiles.js`
- Zmień: `herdr/herdr-composer/mods/herdr-composer/catalog.js` (przenieś `BUILTINS` i `AGENT_ALIASES` do `profiles.js`, w `catalog.js` zostaw `export { BUILTINS } from "./profiles.js"`)
- Test: `tests/profiles.test.mjs`
**Interfejsy (produkuje):**
- Typy (JSDoc):
- `Source = {scope:"project"|"home", path:string, pattern:"*.md"|"*/SKILL.md", prefix:string}`, albo `{scope:"home", kind:"claude-plugins"}`;
- `Profile = {id:string, match:string[], builtins:{key:string, desc:string}[], sources:Source[]}` (wszystko znormalizowane: `desc` domyślnie `""`, `prefix` domyślnie `"/"`).
- `export const PROFILES_FILE = "composer-agents.json"`
- `export const BUILTINS`: bez zmian treści.
- `export const DEFAULT_PROFILES: Profile[]`:
- `claude-code`: `match ["claude-code","claude"]`, builtins = `BUILTINS["claude-code"]`, sources w tej kolejności:
1. project `.claude/commands` `*.md`;
2. project `.claude/skills` `*/SKILL.md`;
3. home `.claude/commands` `*.md`;
4. home `.claude/skills` `*/SKILL.md`;
5. `{scope:"home", kind:"claude-plugins"}`.
- `codex`: `match ["codex"]`, builtins = `BUILTINS.codex`, `sources []`.
- `export function parseProfiles(text: string|null|undefined): {profiles: Profile[], problem: string|null}`
- `null`/`undefined` (brak pliku) daje `{profiles: [], problem: null}`.
- Usuwa BOM. Zły JSON daje `{profiles: [], problem: "nieczytelny JSON"}`.
- Brak `agents` albo `agents` nie jest tablicą: `problem: "brak listy agents"`.
- Profil bez `id` (string) albo bez niepustego `match` (lista stringów) jest pomijany. Źródło z `path` bezwzględnym (`/x`, `C:/x`, `C:\x`, `\\x`) lub z segmentem `..`, nieznanym `scope` albo nieznanym `pattern` jest pomijane. Builtin bez `key` (string) jest pomijany.
- Coś pominięto, a reszta działa: `problem: "pominięto <n> wpisów"`, gdzie `n` to liczba pominiętych profili, źródeł i builtinów razem.
- `export function resolveProfile(userProfiles: Profile[], agent: string): Profile|null`: najpierw `userProfiles`, potem `DEFAULT_PROFILES`; pierwszy, którego `match` zawiera `agent` (bez rozróżniania wielkości liter, po `trim()`). `""` i `"default"` dają `null`, chyba że ktoś jawnie wpisał je w `match`.
- [ ] **Krok 1: testy (RED)** w `tests/profiles.test.mjs`:
- `resolveProfile([], "claude")` i `resolveProfile([], "Claude-Code")` → `id === "claude-code"`; `resolveProfile([], "codex").id === "codex"`; `resolveProfile([], "kiro-cli") === null`; `resolveProfile([], "default") === null`.
- Profil z pliku `{id:"claude-code", match:["claude-code"], builtins:[{key:"x"}]}` wygrywa z domyślnym: `builtins` to tylko `x`, a `sources` jest puste (brak `claude-plugins`).
- `parseProfiles(null)` → `{profiles:[], problem:null}`.
- `parseProfiles("\uFEFF{\"agents\":[{\"id\":\"kiro\",\"match\":[\"kiro-cli\"],\"sources\":[{\"scope\":\"home\",\"path\":\".kiro/prompts\",\"pattern\":\"*.md\",\"prefix\":\"@\"}]}]}\r\n")` → jeden profil, źródło z `prefix:"@"`, `problem:null`.
- `parseProfiles("{nope")` → `problem:"nieczytelny JSON"`, `profiles:[]`.
- `parseProfiles('{"agents":{}}')` → `problem:"brak listy agents"`.
- Profil z dwoma źródłami `{path:"../x"}` i `{path:"C:/x"}` oraz jednym dobrym → zostaje 1 źródło, `problem:"pominięto 2 wpisów"`.
- Profil bez `match` jest pominięty, drugi dobry zostaje.
- `pattern:"**/*.md"` jest odrzucony.
- `DEFAULT_PROFILES[0].builtins` ma te same klucze co `BUILTINS["claude-code"]`.
- [ ] **Krok 2:** `npm test` daje FAIL (brak modułu).
- [ ] **Krok 3:** zaimplementuj `profiles.js` i przenieś `BUILTINS` z re-eksportem w `catalog.js`.
- [ ] **Krok 4:** `npm test` daje PASS, łącznie z dzisiejszymi 190 testami.
- [ ] **Krok 5: commit** `feat: agent profiles describe each agent's commands`
---
### Task 2: `catalog.js` czyta źródła profilu i komendy z historii
**Pliki:**
- Zmień: `herdr/herdr-composer/mods/herdr-composer/catalog.js`, `herdr/herdr-composer/mods/herdr-composer/suggest.js`
- Test: `tests/catalog.test.mjs`
**Interfejsy:**
- Konsumuje z Task 1: `Profile`, `Source`, `DEFAULT_PROFILES`, `resolveProfile`.
- Produkuje:
- `suggest.js`: `export const GROUP_HISTORY = "Z historii"`, w `GROUPS` po `GROUP_PLUGIN`, przed `GROUP_TERMINAL`.
- `commands(cwd, exec, options)` z `options = {profile?: Profile|null, snippets?, global?: Item[], history?: Item[], onReadError?}`:
- `profile` null lub brak: tylko `snippets` i `history`, bez `exec`;
- w przeciwnym razie kolejność: builtins profilu, źródła `project` profilu (czytane przez `exec` w `cwd`), `global`, `snippets`, `history`;
- deduplikacja po `key`: pierwszy wygrywa;
- `insert` = `source.prefix + key + " "`.
- Źródła `project` listuje **jedno** `exec` (sh, a PowerShell jako zapas, jak dziś `listProjectFiles`). Ścieżki i wzorce idą jako argumenty (sh) lub przez `decode()` (PS), nie są sklejane w skrypt. Nazwa skilla projektu: zawsze nazwa folderu, bez filtra `user-invocable` (jak dziś).
- `globalCommands(home, exec, readText, options)` z `options = {sources: Source[], onReadError?}`:
- czyta tylko źródła `scope:"home"` z `sources`; `kind:"claude-plugins"` daje dzisiejszą logikę pluginów (`~/.claude/settings.json` itd.);
- źródło `home` `{path, pattern}` daje dzisiejszy spec `md` / `skills` dla `${home}/${path}`;
- nazwy i filtr `user-invocable` jak dziś; `insert` z `prefix` źródła (plugin: `"/"`);
- brak `sources` lub pusta lista: `[]` bez `exec`.
- `export function historyCommands(history: HistoryEntry[], agent: string): Item[]`:
- wpisy z `agentName` równym `agent` (bez wielkości liter, `trim`), od najnowszego `sentAt`;
- pierwszy token `text.trimStart()` pasujący do `/^\/[A-Za-z0-9][\w:.-]*$/`;
- `key` bez `/`, `desc: ""`, `group: GROUP_HISTORY`, `insert: "/"+key+" "`;
- bez duplikatów.
- `export function unknownAgentMessage(agent: string): string` oraz `export function profileProblemMessage(problem: string): string`: teksty z Ograniczeń globalnych.
- Usuń `isClaudeCode` i `LIST_SH`/`LIST_PS` na sztywno. Test `isClaudeCode` zastępują testy `resolveProfile` z Task 1, więc usuwasz go.
- [ ] **Krok 1: test „CC bez zmian” PRZED zmianą kodu.** Na obecnym kodzie, na fałszywej maszynie z testów (`machine(...)`) z plikami:
- projekt `.claude/commands/a.md`, `.claude/skills/s/SKILL.md` (z `name: inna`);
- home `~/.claude/commands/handoff.md`;
- jeden plugin.
Wywołaj `commands(cwd, exec, {agent:"claude-code", global: await globalCommands(...)})` i wpisz wynik (lista `{key, group, insert, desc}`) jako literał `EXPECTED_CC` w teście. Commit tylko testu: `test: pin the / menu of Claude Code before profiles`. `npm test` daje PASS.
- [ ] **Krok 2: przepisz ten test na nowe API** (`profile: resolveProfile([], "claude-code")`, `globalCommands(..., {sources: profile.sources})`) z tym samym `EXPECTED_CC`. Dodaj testy (RED):
- `commands` z `profile: null`, `history: [h]` daje `[h]` i `exec` nie zostaje wywołane;
- profil `kiro` ze źródłem project `.kiro/prompts` `*.md` `prefix:"@"` daje `{key:"review", insert:"@review ", group:"Projekt"}`;
- `globalCommands` z `sources: []` daje `[]`, bez `exec`;
- `globalCommands` ze źródłem home `.kiro/prompts` daje grupę `Użytkownik`;
- `historyCommands`: wpisy `"/clear"`, `" /superpowers:brainstorming x"`, `"/c/Users/x"`, `"/ cos"`, `"/"`, `"hej /clear"` oraz wpis innego agenta dają dokładnie `["superpowers:brainstorming","clear"]` (gdy `brainstorming` jest nowszy), w grupie `Z historii`;
- `commands` z builtin `clear` i historią `clear` daje jedno `clear` z grupy `Wbudowane`;
- `GROUPS` zawiera `"Z historii"` zaraz po `"Pluginy"`;
- istniejące testy `globalCommands` dostają mechanicznie `{sources: DEFAULT_PROFILES[0].sources}`.
- [ ] **Krok 3:** `npm test` daje FAIL na nowych testach.
- [ ] **Krok 4:** zaimplementuj.
- [ ] **Krok 5:** `npm test` daje PASS, z `EXPECTED_CC` bez zmian.
- [ ] **Krok 6: commit** `feat: the / menu reads the sources of the agent's profile and its history`
---
### Task 3: `main.js`, czyli plik profili, cache per profil, wiersze informacyjne i README
**Pliki:**
- Zmień: `herdr/herdr-composer/mods/herdr-composer/main.js` (`updateSuggestions` ~2213, `refreshGlobal` ~2228, `loadSuggestions` ~2275, `renderMenu` ~2824, stan w `init` ~199), `herdr/herdr-composer/mods/herdr-composer/catalog.js` (jedna czysta funkcja niżej), README moda (sekcja „Inni agenci”)
- Test: `tests/catalog.test.mjs`
**Interfejsy:**
- Konsumuje: `parseProfiles`, `resolveProfile`, `PROFILES_FILE` (Task 1); `commands`, `globalCommands`, `historyCommands`, `unknownAgentMessage`, `profileProblemMessage` (Task 2).
- Produkuje w `catalog.js`: `export function menuNotes({profile, agent, profilesLoaded, problem}): string[]`:
- `[profileProblemMessage(problem)]`, gdy `problem`;
- plus `unknownAgentMessage(agent)`, gdy `!profile && profilesLoaded`;
- kolejność: najpierw nieznany agent, potem problem.
- Stan w `main.js`:
- `this.userProfiles = []`, `this.profileProblem = null`, `this.profilesLoaded = false`;
- `this.globalCommands = new Map()` (klucz `profile.id`, wartość `Item[]`) i `this.globalLoadedAt = new Map()`, zamiast dzisiejszych pojedynczych pól;
- flaga `this.globalLoading` jak dziś.
- `refreshGlobal(cx)`:
1. gdy minęło 60 s od ostatniego odczytu pliku: `readTextFile([appHome(), PROFILES_FILE].join("\\"))`, potem `parseProfiles` i ustawienie trzech pól oraz `profilesLoaded = true`;
2. `profile = resolveProfile(this.userProfiles, agentName(target))`; gdy profil ma źródła `home` i cache dla `profile.id` jest pusty lub starszy niż 60 s, `globalCommands(home(), exec, readTextFile, {sources: profile.sources, onReadError})` zapisuje wynik pod `profile.id`;
3. po zakończeniu, gdy menu `/` jest otwarte, przeładuj menu tak jak dziś.
W `updateSuggestions` wołaj `refreshGlobal` dla **każdego** agenta przy `/` (usuń warunek `isClaudeCode`). `checking()` blokuje jak dziś.
- `loadSuggestions`, gałąź `/`:
- `profile = resolveProfile(this.userProfiles, agentName(agent))`;
- `commands(cwd, exec, {profile, snippets: [], global: this.globalCommands.get(profile?.id) ?? [], history: catalog.historyCommands(storage.loadHistory(this.store), agentName(agent)), onReadError})`;
- `this.menu.notes = catalog.menuNotes({...})`.
- `renderMenu`: `notes` jako szare (`t.dim`, `text_size(11.5)`) wiersze **pod** pozycjami, w tej samej przewijanej liście. Nie da się ich wybrać, a indeksy pozycji i `scroll_to_item` się nie zmieniają. Komunikat „Żadna komenda nie pasuje” nie pojawia się, gdy pozycji nie ma, a są `notes` z nieznanym agentem.
- README: sekcja „Inni agenci”:
- klucz bierzesz z wiersza „Nieznany agent …”;
- ścieżka pliku i format (pola z tabeli w specu);
- że plik nadpisuje profil o tym samym `id` w całości;
- przykład dla kiro z nagłówkiem „przykład niesprawdzony”.
- [ ] **Krok 1: testy (RED)** `menuNotes`:
- `{profile:null, agent:"kiro-cli", profilesLoaded:true}` daje 1 wiersz zawierający `` `kiro-cli` ``;
- to samo przy `profilesLoaded:false` daje `[]`;
- profil plus `problem:"nieczytelny JSON"` daje `["`composer-agents.json`: nieczytelny JSON"]`;
- `profile:null`, `problem` i `profilesLoaded:true` dają 2 wiersze, najpierw nieznany agent.
- [ ] **Krok 2:** `npm test` daje FAIL.
- [ ] **Krok 3:** zaimplementuj `menuNotes`, zmiany w `main.js` i README.
- [ ] **Krok 4:** `npm test` daje PASS. `grep -n isClaudeCode herdr/herdr-composer/mods/herdr-composer/*.js` nic nie znajduje.
- [ ] **Krok 5: commit** `feat: the composer reads agent profiles from composer-agents.json`
---
## Po wykonaniu (Ovis Opus, nie wykonawca)
- Instalacja: `powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1`, potem `herdr-app status` musi dać `"errors": []`.
- GUI: menu `/` w CC wygląda tak jak przed zmianą.
- Plik testowy `composer-agents.json` z profilem `codex` ze źródłem home `.claude/commands` daje `handoff` w menu codex w ciągu 60 s.
- Uszkodzony plik daje wiersz z powodem. Po teście usuń plik.
@@ -0,0 +1,39 @@
# 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.
@@ -0,0 +1,122 @@
# Profile agentów dla menu `/` — projekt
Data: 2026-11-20 · Gałąź: `feature/composer-dock` · Mod: `herdr/herdr-composer/mods/herdr-composer/`
## Cel i powód
Menu `/` composera ma podpowiadać komendy każdego agenta, nie tylko Claude Code. Na tej maszynie są Claude Code i codex. Kiro-cli i Antigravity CLI działają na innych komputerach i nie da się ich tu uruchomić. Nie znamy więc ich kluczy `agentName()` ani ich komend i nie wolno ich zgadywać. Rozwiązanie musi działać bez tej wiedzy w kodzie. Użytkownik dopisuje ją w pliku na maszynie, na której agent działa, bez zmian w kodzie i bez reinstalacji moda.
## Dziś
- `agentName(agent)` (`view.js:60`) zwraca `agent.app`, potem `program.key`, a w ostateczności `"default"`.
- `catalog.js` ma na sztywno:
- `BUILTINS["claude-code"]` (49 komend) i `BUILTINS.codex` (4 komendy);
- alias `claude` → `claude-code`;
- `isClaudeCode()`, które decyduje, czy czytać `.claude/commands`, `.claude/skills` projektu oraz `~/.claude` z pluginami (`globalCommands`).
- Agent spoza tej listy dostaje w menu `/` tylko snippety, a te dziś są zawsze puste (`snippets: []` w `main.js`).
- Historia (`storage.loadHistory`, do 500 wpisów, wspólna) zapisuje każdą wysłaną wiadomość z polem `agentName` = `agentName(agent)` (`main.js`, `recordSent`).
## Cele
1. **Profil agenta** opisuje: jakie nazwy z `agentName()` do niego pasują, jakie ma wbudowane komendy i skąd czytać jego własne komendy (folder projektu i folder domowy).
2. **Domyślne profile w kodzie** dla `claude-code` (z aliasem `claude`) i `codex`. Zachowują dzisiejsze działanie: te same komendy, grupy, kolejność i deduplikację.
3. **Plik użytkownika** `~/.config/herdr-app/composer-agents.json` (obok `shared.json`) dodaje nowe profile albo nadpisuje domyślne.
4. **Komendy z historii:** każde `/słowo` z początku wiadomości wysłanej wcześniej do agenta o tym samym `agentName` trafia do menu jako osobna grupa.
5. **Nieznany agent:** kiedy żaden profil nie pasuje, menu pokazuje wiersz informacyjny z dokładnym kluczem, który trzeba wpisać w pliku.
## Układ maszyn
Każdy komputer ma własną instalację herdr-app z tym modem, a agent działa lokalnie obok GUI (decyzja użytkownika). Plik profili, folder domowy i źródła są czytane lokalnie, bez `on: machine`. Agenci na zdalnych maszynach przez herdr-core są poza zakresem.
## Poza zakresem
- Edytor profili w GUI.
- Wpisywanie do kodu profili kiro-cli i Antigravity. Dostarczamy tylko przykład w README, wyraźnie oznaczony jako niesprawdzony.
- Inny wyzwalacz menu niż `/`.
- Zagnieżdżone skille (`~/.claude/skills/synced/`), czyli znany brak, który zostaje.
- `clipboard.js` `IMAGE_APPS`.
## Anty-cele (porażka, nawet jeśli działa)
- Jakakolwiek zmiana menu `/` dla Claude Code: inna lista, inne grupy, inna kolejność albo wolniejsze działanie.
- Uszkodzony lub brakujący plik użytkownika psuje menu. Ma wtedy działać na domyślnych profilach.
- Zgadywanie w kodzie kluczy lub komend agentów, których nie widzieliśmy.
## Podejścia (rozważone)
- **Skąd brać komendy nieznanego agenta:** (1) profile w pliku, (2) nauka z użycia, (3) oba. **Wybrane: oba** (decyzja użytkownika).
- **Gdzie trzymać profile:**
- **A.** Domyślne w kodzie plus plik w home.
- **B.** `shared()` z edytorem w GUI.
- **C.** `agents.json` w folderze moda.
- **Wybrane: A** (decyzja użytkownika). B oznacza dużo GUI do rzadkiej czynności. C nadpisuje `install.ps1` przy aktualizacji.
- **Nauka z użycia:** nowy magazyn albo odczyt historii. **Wybrane: historia** (moja decyzja). Ma już `agentName`, więc nie trzeba nowego klucza ani nowego zapisu.
## Format pliku `composer-agents.json`
```json
{
"agents": [
{
"id": "kiro",
"match": ["kiro-cli", "kiro"],
"builtins": [
{ "key": "context", "desc": "Zarządza kontekstem." },
{ "key": "model" }
],
"sources": [
{ "scope": "project", "path": ".kiro/prompts", "pattern": "*.md" },
{ "scope": "home", "path": ".kiro/prompts", "pattern": "*.md", "prefix": "@" }
]
}
]
}
```
- `id` (wymagany, string): nazwa profilu. Profil z pliku o tym samym `id` co domyślny **zastępuje go w całości**. Bez łączenia list, żeby zachowanie było przewidywalne.
- `match` (wymagany, niepusta lista stringów): wartości `agentName()`, które pasują do profilu. Porównanie dokładne, bez rozróżniania wielkości liter. Pierwszy pasujący profil wygrywa, profile z pliku są sprawdzane przed domyślnymi.
- `builtins` (opcjonalny): `{key, desc?}` trafiają do grupy `Wbudowane`.
- `sources` (opcjonalny): lista źródeł.
- `scope`: `"project"` (względem `cwd` panelu, czytane przez `exec` jak dziś `projectItems`) albo `"home"` (względem folderu domowego, czytane jak dziś `globalCommands`). Odpowiadają grupom `Projekt` i `Użytkownik`.
- `path`: folder względny. Ścieżka bezwzględna i `..` są odrzucane.
- `pattern`: `"*.md"` (nazwa komendy = nazwa pliku bez `.md`) albo `"*/SKILL.md"`. Inne wzorce są odrzucane. Nazwa skilla zależy od zakresu, tak jak dziś *(moja decyzja: CC bez zmian)*:
- `home`: `name:` z frontmattera, a gdy go brak, nazwa folderu; pomija `user-invocable: false`;
- `project`: zawsze nazwa folderu, bez filtra.
- `prefix` (opcjonalny, domyślnie `"/"`): co wstawia wybór z menu (`insert: prefix + key + " "`). Przydaje się agentowi, który wywołuje prompty inaczej niż `/`.
- Specjalne `{ "scope": "home", "kind": "claude-plugins" }` oznacza dzisiejszą logikę pluginów (`settings.json` → `enabledPlugins`, `installed_plugins.json`, `plugin.json`) i daje grupę `Pluginy`. Używa go domyślny profil `claude-code`. Inny profil może go użyć, ale nic poza tym nie robi.
- Domyślny profil `claude-code` w kodzie wyrażony w tym formacie:
- `match: ["claude-code", "claude"]`;
- `builtins`: dzisiejsze 49;
- `sources`: projekt `.claude/commands` `*.md`, projekt `.claude/skills` `*/SKILL.md`, home `.claude/commands` `*.md`, home `.claude/skills` `*/SKILL.md`, `claude-plugins`.
- Domyślny `codex`: `match: ["codex"]`, dzisiejsze 4 builtins, bez źródeł.
- `isClaudeCode()` znika z logiki katalogu. To, czy czytać `.claude`, wynika wyłącznie z profilu.
**Błędy w pliku.** Brak pliku jest normalny i oznacza same domyślne profile. Nieczytelny JSON albo zły kształt (`agents` nie jest listą) oznacza ignorowanie całego pliku. Pojedynczy zły profil lub źródło jest pomijany, reszta działa. Gdy plik został odrzucony w całości albo częściowo, menu `/` pokazuje u dołu jeden wiersz informacyjny: „`composer-agents.json`: <krótki powód>”.
## Komendy z historii
- Źródło: `storage.loadHistory(store)`. Bierzemy wpisy, których `agentName` jest równe bieżącemu `agentName(agent)` (porównanie bez rozróżniania wielkości liter).
- Z tekstu wpisu bierzemy pierwszy token, jeśli tekst po `trimStart()` zaczyna się od `/`, a token pasuje do `^/[A-Za-z0-9][\w:.-]*$`. Klucz to token bez `/`.
- Grupa: nowa `GROUP_HISTORY = "Z historii"`, dopisana na końcu `GROUPS` w `suggest.js` (przed `Terminal`, jeśli ta grupa jest używana w tym menu, inaczej na końcu). Opis to pusty string. `insert: "/" + key + " "`.
- Działa dla każdego agenta, także Claude Code.
## Kolejność i deduplikacja
Źródła są łączone w tej kolejności: builtins, źródła `project` profilu, źródła `home` profilu (w tym pluginy), snippety, historia. Nazwa pojawia się raz: wygrywa pierwsze źródło, które ją ma, tak jak dziś. Dla Claude Code bez historii lista jest identyczna z dzisiejszą.
## Nieznany agent
Żaden profil nie pasuje: menu pokazuje komendy z historii i snippety oraz jeden wiersz informacyjny „Nieznany agent `<agentName>` – dodaj profil w `~/.config/herdr-app/composer-agents.json`”. Wiersza nie da się wybrać (Enter/Tab go pomija, tak jak dzisiejsze komunikaty `NO_MATCH_MESSAGE` / `READ_ERROR_MESSAGE`). Agent o `agentName` = `"default"` też jest „nieznany”.
## Odświeżanie
Ścieżka pliku pochodzi z `appHome()` modułu `herdr` (honoruje `$HERDR_APP_HOME`), nie jest wpisana na sztywno *(moja decyzja)*. Plik profili i źródła `home` są czytane w tle (dzisiejsze `refreshGlobal`) z tym samym TTL 60 s. Pierwsze `/` po starcie nie czeka na plik. Dopóki plik nie został wczytany ani razu, wiersz „Nieznany agent” się nie pokazuje. Po wczytaniu otwarte menu przeładowuje się tak jak dziś *(moja decyzja: bez spowolnienia CC i bez fałszywego komunikatu)*. Zmiana pliku pojawia się w menu w ciągu minuty, bez restartu. Cache źródeł `home` jest trzymany **per profil** (`id`), bo dwa terminale mogą mieć różnych agentów. Źródła `project` są czytane jak dziś, przy każdym otwarciu menu.
## Testy
- Dzisiejsze testy `catalog.test.mjs` przechodzą bez zmian albo z mechaniczną zmianą wywołania.
- Nowe przypadki:
- wynik dla CC identyczny z wynikiem sprzed zmiany (lista kluczy, grup i `insert`);
- plik nadpisuje profil domyślny;
- plik dodaje profil z `prefix: "@"`;
- uszkodzony JSON → domyślne profile i wiersz informacyjny;
- zły profil pominięty, dobry działa;
- ścieżka z `..` odrzucona;
- komendy z historii (filtr agenta, regex, dedup z builtins);
- nieznany agent → wiersz z kluczem.
- GUI na tej maszynie: menu `/` dla CC wygląda tak jak przed zmianą. Plik testowy z profilem dla `codex` (albo z fałszywym `match` dla CC) pokazuje własne komendy w ciągu minuty.
## README
Krótka sekcja „Inni agenci”:
- skąd wziąć klucz (wiersz „Nieznany agent …” w menu);
- format pliku;
- przykład dla kiro, oznaczony jako niesprawdzony.
## Pozostawione wykonawcy
Podział funkcji między `catalog.js` a ewentualny nowy `profiles.js`, nazwy funkcji i dokładny kształt cache w `main.js`. Byle `catalog.js` dalej działał w czystym Node z wstrzykniętymi `exec` i `readText`.
+23 -8
View File
@@ -32,7 +32,10 @@ The window is the `main` layout with one block added. Left to right, top to bott
5. **the card** (rounded 12, 1 px `border`, `raised` background): attachment tiles 5. **the card** (rounded 12, 1 px `border`, `raised` background): attachment tiles
(44 px high: 36 px thumbnail or extension, name, size or reason, "Ponów", x), the (44 px high: 36 px thumbnail or extension, name, size or reason, "Ponów", x), the
field (`background`, rounded 8, 13 px, 1 to 10 rows), and a row of controls: three field (`background`, rounded 8, 13 px, 1 to 10 rows), and a row of controls: three
28 px round buttons `+`, a clock, a star; a flexible gap; the agent pill (rounded 12: 28 px round buttons `+`, a clock, a star; a 1x18 px divider; **the dock** (flexible,
28 px high, scrolls sideways: one 28 px button per saved text, rounded 8, 12 px; a
send button on `chrome`, an insert button with a 1 px dashed `border` and a `✎`
prefix; empty: "Prawy klik w Ulubionych → Przypnij do docka" in `dim`); the agent pill (rounded 12:
a 7 px status dot, the tab's name, the status word, a paperclip and the count when a 7 px status dot, the tab's name, the status word, a paperclip and the count when
files are attached); and a 32 px round button, a white arrow to send, or a white files are attached); and a 32 px round button, a white arrow to send, or a white
square (Stop) when the field is empty and the agent works; square (Stop) when the field is empty and the agent works;
@@ -94,8 +97,17 @@ other than `claude-code`, `codex`, `gemini`, `opencode` asks first ("Anuluj" / "
**History and favourites.** Every message that `hc send` accepted is stored (500, newest **History and favourites.** Every message that `hc send` accepted is stored (500, newest
first, any space or agent). In the panel: type to search (case-insensitive, Polish letters first, any space or agent). In the panel: type to search (case-insensitive, Polish letters
too), Up/Down, Enter inserts at the caret the field had when the panel opened and sends too), Up/Down, Enter inserts at the caret the field had when the panel opened and sends
nothing, Tab switches tab, Ctrl+D or a right click stars a row, Esc or the x closes. The nothing, Tab switches tab, Ctrl+D stars a row at once, a right click opens a menu (Wstaw,
star next to the field stars the text in it (100 favourites). Dodaj do ulubionych / Usuń z ulubionych; in Favourites also Przypnij do docka / Odepnij
z docka), Esc or the x closes. The star next to the field stars the text in it (100
favourites); a right click on it pins the text to the dock.
**Dock.** A row of buttons in the bar, one dock for every agent (30 at most). A click on a
send button sends its text the way Enter does (queue, countdown, `--force` when blocked)
and leaves the field, the draft and the files alone; an insert button puts its text at
the caret. A right click on a button: Zmień nazwę (in place: Enter keeps, Esc drops; an
empty name falls back to the first 15 characters + "…"), Tylko wstawiaj / Wysyłaj od
razu, Przesuń w lewo / w prawo, Usuń z docka. Without an agent the buttons are dimmed.
## Built from ## Built from
@@ -111,13 +123,13 @@ a `focus` border in `accent`.
**Mod** `mods/herdr-composer/` (`mod.json`: `place: none`, `focusable: true`): `main.js` (the **Mod** `mods/herdr-composer/` (`mod.json`: `place: none`, `focusable: true`): `main.js` (the
view), `state.js` (drafts, attachments, queue; pure), `delivery.js` (sending, the gate, view), `state.js` (drafts, attachments, queue; pure), `delivery.js` (sending, the gate,
countdown rules), `storage.js` (the shared store, migration from `ovis-composer.*`), countdown rules), `storage.js` (the shared store, migration from `ovis-composer.*`),
`history.js`, `attachments.js`, `clipboard.js`, `suggest.js`, `catalog.js`, `keys.js`, `history.js`, `attachments.js`, `clipboard.js`, `suggest.js`, `catalog.js`, `profiles.js` (agent profiles), `keys.js`,
`view.js` (helpers), `panel.js` (the panel and the preview). The pure modules import nothing `dock.js` (the dock and its menus; pure), `view.js` (helpers), `panel.js` (the panel and the preview). The pure modules import nothing
from Herdr and are tested with Node (`npm test`). from Herdr and are tested with Node (`npm test`).
**Herdr API:** `agents`, `panes`, `focused`, `theme`, `settings` (`zoom`), `appHome`, **Herdr API:** `agents`, `panes`, `focused`, `theme`, `settings` (`zoom`), `appHome`,
`shared`/`setShared` (the store: `herdr-composer.history`, `.favorites`, `.usage`, `shared`/`setShared` (the store: `herdr-composer.history`, `.favorites`, `.usage`,
`.userMin`, `.draft:<address>`, `.queue:<address>`), `notify` (toast, only for a failed `.userMin`, `.dock`, `.draft:<address>`, `.queue:<address>`), `notify` (toast, only for a failed
send or `hc` call), `nextCommand`, `run("layout.resize", {id: "composer", px})`, send or `hc` call), `nextCommand`, `run("layout.resize", {id: "composer", px})`,
`cx.bind_keys` in the context `herdr-composer > Input` (up, down, tab, ctrl-r, `cx.bind_keys` in the context `herdr-composer > Input` (up, down, tab, ctrl-r,
ctrl-enter, alt-enter, escape), `fs/promises` (the paste folder), gpui-kit and gpui-base ctrl-enter, alt-enter, escape), `fs/promises` (the paste folder), gpui-kit and gpui-base
@@ -152,7 +164,7 @@ It makes no network request.
to (`herdr-composer.userMin`), 120-520, resized after 120 ms and only for a difference to (`herdr-composer.userMin`), 120-520, resized after 120 ms and only for a difference
over 4 px; the panel pauses it. over 4 px; the panel pauses it.
- Row handlers cannot live inside a `v_virtual_list` renderer: a row click uses - Row handlers cannot live inside a `v_virtual_list` renderer: a row click uses
`on_item_click`, so the star in a panel row is a sign; Ctrl+D or a right click toggle it. `on_item_click`; the star in a panel row is found by where `on_mouse_down` on the list landed (STAR_ZONE, right edge). Ctrl+D or a right click toggle it too.
- `image()` draws only files inside the app's folder (give it the path relative to - `image()` draws only files inside the app's folder (give it the path relative to
`appHome()`): thumbnails exist for pasted images; an image from elsewhere gets a tile `appHome()`): thumbnails exist for pasted images; an image from elsewhere gets a tile
with its extension and no preview. with its extension and no preview.
@@ -163,7 +175,7 @@ It makes no network request.
copies them, so it reloads the mod). copies them, so it reloads the mod).
- Windows only: the clipboard, the `+` dialog and the file sizes use PowerShell. - Windows only: the clipboard, the `+` dialog and the file sizes use PowerShell.
- Limits: 20 000 characters a message, 32 MiB a file, 100 files a message, history 500, - Limits: 20 000 characters a message, 32 MiB a file, 100 files a message, history 500,
favourites 100, the menu shows 20 rows. favourites 100, the dock 30 buttons, the menu shows 20 rows.
- The layout is a clone: it keeps the look of `main` as of 0.1.16 and does not follow later - The layout is a clone: it keeps the look of `main` as of 0.1.16 and does not follow later
changes of `main`. changes of `main`.
- Data kept under `ovis-composer.*` by the earlier name is read when the new key is empty - Data kept under `ovis-composer.*` by the earlier name is read when the new key is empty
@@ -183,4 +195,7 @@ It makes no network request.
- Ctrl+R opens the panel with the sent messages; search lights the match; Enter inserts at - Ctrl+R opens the panel with the sent messages; search lights the match; Enter inserts at
the caret and sends nothing; Esc closes it and the block returns to its height. the caret and sends nothing; Esc closes it and the block returns to its height.
- Ctrl+Shift+Space focuses the field; clicking a terminal gives that terminal the keys. - Ctrl+Shift+Space focuses the field; clicking a terminal gives that terminal the keys.
- A right click on a Favourites row pins it to the dock; a click on the button sends it
and leaves the draft; a right click on the button renames, moves, switches the mode and
removes it; the dock survives a reload.
- `npm test` passes. - `npm test` passes.
@@ -6,10 +6,12 @@
// reads the person's snippets and passes them in, and it schedules the retry // reads the person's snippets and passes them in, and it schedules the retry
// and the debounce with the numbers exported here. // and the debounce with the numbers exported here.
// //
// Three sources for `/` (the design's §5.3): the built-in commands of the // Sources for `/`: the profile of the agent (profiles.js) says which are
// agent, the project's own `.claude/commands/*.md` and // read - its built-in commands, the folders of the project and of the home
// `.claude/skills/*/SKILL.md`, and the person's saved snippets. One source // folder with its own commands, the plugins - and the person's snippets and
// for `@`: the files git tracks in the pane's folder. // the commands sent to this agent before (the history) come on top. An agent
// with no profile gets only the snippets and the history, and nothing is
// read for it. One source for `@`: the files git tracks in the pane's folder.
// //
// A read that fails is not an empty list: the failure is reported through // A read that fails is not an empty list: the failure is reported through
// `onReadError` and the menu keeps what it knows. A caller with no handler // `onReadError` and the menu keeps what it knows. A caller with no handler
@@ -17,7 +19,14 @@
// with nothing to show. An empty list without a failure means the catalog // with nothing to show. An empty list without a failure means the catalog
// was read and nothing fit. // was read and nothing fit.
import { GROUP_BUILTIN, GROUP_PROJECT, GROUP_USER, rank } from "./suggest.js"; import {
GROUP_BUILTIN,
GROUP_PROJECT,
GROUP_USER,
GROUP_PLUGIN,
GROUP_HISTORY,
rank,
} from "./suggest.js";
import { decode } from "./powershell.js"; import { decode } from "./powershell.js";
/** /**
@@ -47,39 +56,51 @@ export const NO_MATCH_MESSAGE = "Żadna komenda nie pasuje. Zmień słowo albo p
/** The same, for the files of an `@`. */ /** The same, for the files of an `@`. */
export const NO_FILE_MATCH_MESSAGE = "Żaden plik nie pasuje. Zmień słowo albo pisz dalej."; export const NO_FILE_MATCH_MESSAGE = "Żaden plik nie pasuje. Zmień słowo albo pisz dalej.";
/** The built-in commands of the agents, the small list the design names. */ export { BUILTINS } from "./profiles.js";
export const BUILTINS = {
"claude-code": [
{ key: "clear", desc: "Czyści historię rozmowy." },
{ key: "compact", desc: "Ścisza historię do podsumowania." },
{ key: "model", desc: "Wybiera model." },
{ key: "permissions", desc: "Ustawia uprawnienia narzędzi." },
{ key: "config", desc: "Otwiera ustawienia." },
{ key: "resume", desc: "Wznawia wcześniejszą sesję." },
],
codex: [
{ key: "model", desc: "Wybiera model." },
{ key: "approvals", desc: "Ustawia sposób zatwierdzania poleceń." },
{ key: "new", desc: "Zaczyna nową sesję." },
{ key: "resume", desc: "Wznawia wcześniejszą sesję." },
],
};
/** The same agent under the name the program's table gives it. */
const AGENT_ALIASES = { claude: "claude-code" };
/** How many files the `@` menu shows at most. */ /** How many files the `@` menu shows at most. */
const FILE_LIMIT = 20; const FILE_LIMIT = 20;
/** The project's command files, as a shell finds them. */ /** One command: a `/` and a name that holds no space and no path separator. */
const LIST_SH = const HISTORY_COMMAND = /^\/[A-Za-z0-9][\w:.-]*$/;
'for f in .claude/commands/*.md .claude/skills/*/SKILL.md; do [ -f "$f" ] && printf \'%s\\n\' "$f"; done; exit 0';
/** The same in PowerShell, for a machine without a POSIX shell. */ /** The message of a pane whose agent has no profile. */
const LIST_PS = export function unknownAgentMessage(agent) {
"[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false); " + return `Nieznany agent \`${agent}\` – dodaj profil w ~/.config/herdr-app/composer-agents.json`;
"@(Get-ChildItem -Path '.claude/commands/*.md','.claude/skills/*/SKILL.md' -File -ErrorAction SilentlyContinue) " + }
"| ForEach-Object { Resolve-Path -Relative -LiteralPath $_.FullName }";
/** The message about a `composer-agents.json` that could not be read whole. */
export function profileProblemMessage(problem) {
return `\`composer-agents.json\`: ${problem}`;
}
/**
* The grey rows under the items of the `/` menu: the agent has no profile
* (once the file of the profiles was read - before that we do not know yet)
* and the file of the profiles could not be read whole. They cannot be picked.
*
* @param {{profile:object|null, agent:string, profilesLoaded:boolean, problem:string|null}} state
* @returns {string[]}
*/
export function menuNotes({ profile, agent, profilesLoaded, problem }) {
const notes = [];
if (!profile && profilesLoaded) notes.push(unknownAgentMessage(agent));
if (problem) notes.push(profileProblemMessage(problem));
return notes;
}
/**
* The listing with a POSIX shell, for the project and for the home folder:
* the arguments come in threes - the index of the spec, its kind (`file`,
* `md` or `skills`) and its path - and every file found is written as
* `index<TAB>path`.
*/
const LIST_SH =
'while [ $# -ge 3 ]; do i=$1; k=$2; p=$3; shift 3; case "$k" in ' +
'file) [ -f "$p" ] && printf \'%s\\t%s\\n\' "$i" "$p";; ' +
'md) for f in "$p"/*.md; do [ -f "$f" ] && printf \'%s\\t%s\\n\' "$i" "$f"; done;; ' +
'skills) for f in "$p"/*/SKILL.md; do [ -f "$f" ] && printf \'%s\\t%s\\n\' "$i" "$f"; done;; ' +
"esac; done; exit 0";
/** Reading one file with a POSIX shell. */ /** Reading one file with a POSIX shell. */
const READ_SH = 'cat -- "$1"'; const READ_SH = 'cat -- "$1"';
@@ -97,8 +118,12 @@ export function retryDelay(attempt) {
} }
/** /**
* The commands the `/` menu offers: the agent's built-ins, the project's own * The commands the `/` menu offers, in this order: the built-ins of the
* and the person's snippets. * profile, the project sources of the profile (read with `exec` in `cwd`),
* the global ones (`options.global`, read by `globalCommands`), the snippets
* and the history (`historyCommands`). A name is offered once: the first
* source that has it wins. Without a profile only the snippets and the
* history are offered, and nothing is read (no `exec`).
* *
* A source that cannot be read does not take the others with it: the menu * A source that cannot be read does not take the others with it: the menu
* shows what is known and the failure goes to `onReadError`, so the caller * shows what is known and the failure goes to `onReadError`, so the caller
@@ -107,16 +132,22 @@ export function retryDelay(attempt) {
* *
* @param {string} cwd - the folder of the pane * @param {string} cwd - the folder of the pane
* @param {Exec} exec * @param {Exec} exec
* @param {{agent?:string, snippets?:object[], onReadError?:(error:Error) => void}} [options] * @param {{profile?:object|null, snippets?:object[], global?:Item[], history?:Item[], onReadError?:(error:Error) => void}} [options]
* @returns {Promise<Item[]>} * @returns {Promise<Item[]>}
*/ */
export async function commands(cwd, exec, options = {}) { export async function commands(cwd, exec, options = {}) {
const builtins = builtinItems(options.agent); const profile = options.profile ?? null;
const snippets = snippetItems(options.snippets); const snippets = snippetItems(options.snippets);
const history = Array.isArray(options.history) ? options.history : [];
// An agent we know nothing about: nothing to read.
if (!profile) return dedupe([...snippets, ...history]);
const builtins = builtinItems(profile);
let project = []; let project = [];
try { try {
project = await projectItems(cwd, exec); project = await projectItems(cwd, exec, profile.sources);
} catch (err) { } catch (err) {
// Nobody to tell: the caller gets the failure instead of a list that // Nobody to tell: the caller gets the failure instead of a list that
// looks empty - an empty list would say "nothing fits" and the caller // looks empty - an empty list would say "nothing fits" and the caller
@@ -125,7 +156,198 @@ export async function commands(cwd, exec, options = {}) {
else throw err; else throw err;
} }
return [...builtins, ...project, ...snippets]; const global = Array.isArray(options.global) ? options.global : [];
return dedupe([...builtins, ...project, ...global, ...snippets, ...history]);
}
/** A name is offered once: the first source that has it wins. */
function dedupe(items) {
const seen = new Set();
const out = [];
for (const item of items) {
if (seen.has(item.key)) continue;
seen.add(item.key);
out.push(item);
}
return out;
}
/**
* The commands that were sent to this agent before: the first word of every
* message of the history that starts with a `/` and is a command name (not a
* path such as /c/Users/x). The newest come first.
*
* @param {{text?:string, agentName?:string, sentAt?:number}[]} history
* @param {string} agent - `agentName()` of the pane
* @returns {Item[]}
*/
export function historyCommands(history, agent) {
const name = String(agent ?? "").trim().toLowerCase();
if (!Array.isArray(history)) return [];
const entries = history
.filter((entry) => String(entry?.agentName ?? "").trim().toLowerCase() === name)
.sort((a, b) => (Number(b.sentAt) || 0) - (Number(a.sentAt) || 0));
const seen = new Set();
const items = [];
for (const entry of entries) {
const token = String(entry.text ?? "").trimStart().split(/\s/, 1)[0];
if (!HISTORY_COMMAND.test(token)) continue;
const key = token.slice(1);
if (seen.has(key)) continue;
seen.add(key);
items.push({ key, desc: "", group: GROUP_HISTORY, insert: `/${key} ` });
}
return items;
}
/**
* The commands that live in the person's `~/.claude`: their own commands and
* skills, and those of the plugins that `settings.json` switches on.
*
* Reads the two JSON files and the `plugin.json` of every enabled plugin
* with `readText` (a missing or broken file is an empty source), lists the
* files in one `exec`, reads each of them with `readText`. A listing that
* fails goes to `onReadError` - without a handler the call rejects.
*
* @param {string} home - the person's home folder
* @param {Exec} exec
* @param {(path:string) => Promise<string|null>} readText
* @param {{sources?:object[], onReadError?:(error:Error) => void}} [options]
* `sources`: the sources of the profile; only the ones of the `home` scope
* are read, and none of them means nothing is read
* @returns {Promise<Item[]>}
*/
export async function globalCommands(home, exec, readText, options = {}) {
const root = slashes(home).replace(/\/+$/, "");
const claude = `${root}/.claude`;
const sources = (Array.isArray(options.sources) ? options.sources : []).filter(
(source) => source?.scope === "home",
);
/** @type {{kind:"file"|"md"|"skills", path:string, plugin:string|null, prefix:string}[]} */
const specs = [];
for (const source of sources) {
if (source.kind === "claude-plugins") {
const settings = await readJson(readText, `${claude}/settings.json`);
const installed = await readJson(readText, `${claude}/plugins/installed_plugins.json`);
const enabled =
settings && typeof settings.enabledPlugins === "object" ? settings.enabledPlugins : {};
for (const [id, on] of Object.entries(enabled ?? {})) {
if (on !== true) continue;
const entries = installed?.plugins?.[id];
const installPath = Array.isArray(entries) ? entries[0]?.installPath : null;
if (typeof installPath !== "string" || installPath === "") continue;
const base = slashes(installPath).replace(/\/+$/, "");
const name = id.split("@")[0];
const manifest = await readJson(readText, `${base}/.claude-plugin/plugin.json`);
specs.push(...pluginSpecs(base, name, manifest).map((spec) => ({ ...spec, prefix: "/" })));
}
} else {
specs.push({
kind: source.pattern === "*/SKILL.md" ? "skills" : "md",
path: `${root}/${source.path}`,
plugin: null,
prefix: source.prefix ?? "/",
});
}
}
// Nothing to look at: no `exec` either.
if (specs.length === 0) return [];
let listed = [];
try {
listed = (await listFiles(exec, specs)).found;
} catch (err) {
if (options.onReadError) options.onReadError(err);
else throw err;
return [];
}
const items = [];
for (const { index, path } of listed) {
const spec = specs[index];
if (!spec) continue;
const text = await readText(path);
if (text === null || text === undefined) continue;
const { fields } = frontmatter(String(text));
if (fields["user-invocable"] === "false") continue;
const own = commandName(path);
const isSkill = path.toLowerCase().endsWith("/skill.md");
const name = isSkill && fields.name ? fields.name : own;
if (!name) continue;
const key = spec.plugin ? `${spec.plugin}:${name}` : name;
items.push({
key,
desc: describe(text),
group: spec.plugin ? GROUP_PLUGIN : GROUP_USER,
insert: `${spec.prefix}${key} `,
});
}
return items;
}
/** Backslashes of a Windows path become slashes. */
function slashes(path) {
return String(path).replace(/\\/g, "/");
}
/** A JSON file, or `null` when it is missing or broken. */
async function readJson(readText, path) {
try {
const text = await readText(path);
if (text === null || text === undefined) return null;
return JSON.parse(String(text).replace(/^\uFEFF/, ""));
} catch {
return null;
}
}
/**
* Where a plugin keeps its commands. `skills` and `commands` of its
* `plugin.json` may be a list of paths (a skill's folder or a `.md` file), a
* folder to look through, or missing (the default folders).
*/
function pluginSpecs(base, plugin, manifest) {
const join = (rel) => `${base}/${String(rel).replace(/^\.\//, "").replace(/\/+$/, "")}`;
const out = [];
const skills = manifest?.skills;
if (skills === undefined || skills === null) {
out.push({ kind: "skills", path: join("skills"), plugin });
} else if (typeof skills === "string") {
out.push({ kind: "skills", path: join(skills), plugin });
} else if (Array.isArray(skills)) {
for (const rel of skills) {
if (typeof rel !== "string") continue;
const path = join(rel);
out.push({ kind: "file", path: /\.md$/i.test(path) ? path : `${path}/SKILL.md`, plugin });
}
}
const cmds = manifest?.commands;
if (cmds === undefined || cmds === null) {
out.push({ kind: "md", path: join("commands"), plugin });
} else if (typeof cmds === "string") {
const path = join(cmds);
out.push({ kind: /\.md$/i.test(path) ? "file" : "md", path, plugin });
} else if (Array.isArray(cmds)) {
for (const rel of cmds) {
if (typeof rel !== "string") continue;
const path = join(rel);
out.push({ kind: /\.md$/i.test(path) ? "file" : "md", path, plugin });
}
}
return out;
} }
/** /**
@@ -158,30 +380,44 @@ export async function files(cwd, exec, options = {}) {
return rank(items, needle, { atLineStart: true }).slice(0, limit); return rank(items, needle, { atLineStart: true }).slice(0, limit);
} }
/** The built-in commands of one agent - an agent we do not know has none. */ /** The built-in commands of a profile. */
function builtinItems(agent) { function builtinItems(profile) {
const name = String(agent ?? ""); return (profile.builtins ?? []).map((item) => ({
const list = BUILTINS[name] ?? BUILTINS[AGENT_ALIASES[name]];
if (!list) return [];
return list.map((item) => ({
key: item.key, key: item.key,
desc: item.desc, desc: item.desc ?? "",
group: GROUP_BUILTIN, group: GROUP_BUILTIN,
insert: `/${item.key} `, insert: `/${item.key} `,
})); }));
} }
/** The commands the project has: its command files and its skills. */ /** The commands the project has, as the project sources of the profile say. */
async function projectItems(cwd, exec) { async function projectItems(cwd, exec, sources) {
const { kind, paths } = await listProjectFiles(cwd, exec); const specs = (Array.isArray(sources) ? sources : [])
.filter((source) => source?.scope === "project" && !source.kind)
.map((source) => ({
kind: source.pattern === "*/SKILL.md" ? "skills" : "md",
path: source.path,
prefix: source.prefix ?? "/",
}));
// Nothing to look at: no `exec` either.
if (specs.length === 0) return [];
const { shell, found } = await listFiles(exec, specs, { cwd, shellFirst: true, relative: true });
const items = []; const items = [];
for (const path of paths) { for (const { index, path } of found) {
const spec = specs[index];
if (!spec) continue;
const name = commandName(path); const name = commandName(path);
if (!name) continue; if (!name) continue;
const text = await readFile(cwd, exec, path, kind); const text = await readFile(cwd, exec, path, shell);
if (text === null) continue; if (text === null) continue;
items.push({ key: name, desc: describe(text), group: GROUP_PROJECT, insert: `/${name} ` }); items.push({
key: name,
desc: describe(text),
group: GROUP_PROJECT,
insert: `${spec.prefix}${name} `,
});
} }
return items; return items;
} }
@@ -207,44 +443,58 @@ function snippetItems(snippets) {
} }
/** /**
* The project's command files. A POSIX shell is asked first - it is what a * The files of the specs, listed by one `exec`. For the home folder it is
* Linux or macOS machine has - and PowerShell after it, for a Windows machine * PowerShell first (the machine this mod is made for) and a POSIX shell after
* without one. Neither is there: the catalog could not be read. * it; for the project (`options.shellFirst`) a POSIX shell first - it is what
* a Linux or macOS machine has - and PowerShell after it. Neither is there:
* the listing could not be read. The paths of the specs reach PowerShell
* only as Base64 of a JSON text (`decode`). With `options.relative` the
* paths found are relative to `options.cwd`, as the specs are.
*
* @returns {Promise<{shell:"sh"|"powershell", found:{index:number, path:string}[]}>}
*/ */
async function listProjectFiles(cwd, exec) { async function listFiles(exec, specs, options = {}) {
const viaShell = await tryList(exec, "sh", ["-c", LIST_SH, "catalog"], cwd, false); const relative = options.relative === true;
if (viaShell) return { kind: "sh", paths: viaShell }; const psScript =
"$ErrorActionPreference = 'Stop'; [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false); " +
`$specs = ConvertFrom-Json (${decode(JSON.stringify(specs.map((spec, i) => ({ i, k: spec.kind, p: spec.path, r: relative }))))}); ` +
"foreach ($s in $specs) { $p = $s.p; " +
"if ($s.k -eq 'file') { if (Test-Path -LiteralPath $p -PathType Leaf) { \"$($s.i)`t$p\" } } " +
"elseif (Test-Path -LiteralPath $p -PathType Container) { " +
"if ($s.k -eq 'md') { Get-ChildItem -LiteralPath $p -Filter '*.md' -File | ForEach-Object { " +
"$o = if ($s.r) { \"$p/$($_.Name)\" } else { $_.FullName }; \"$($s.i)`t$o\" } } " +
"else { Get-ChildItem -LiteralPath $p -Directory | ForEach-Object { $f = Join-Path $_.FullName 'SKILL.md'; " +
"if (Test-Path -LiteralPath $f -PathType Leaf) { " +
"$o = if ($s.r) { \"$p/$($_.Name)/SKILL.md\" } else { $f }; \"$($s.i)`t$o\" } } } } }";
const viaPowerShell = await tryList( const shArgs = ["-c", LIST_SH, "catalog"];
exec, specs.forEach((spec, i) => shArgs.push(String(i), spec.kind, spec.path));
"powershell",
["-NoProfile", "-Command", LIST_PS],
cwd,
true,
);
if (viaPowerShell) return { kind: "powershell", paths: viaPowerShell };
throw new Error("nie udało się wczytać katalogu projektu"); const tries = [
} ["powershell", ["-NoProfile", "-Command", psScript]],
["sh", shArgs],
];
if (options.shellFirst) tries.reverse();
/** One listing, or `null` when the program is not there or it failed. */ for (const [command, args] of tries) {
async function tryList(exec, command, args, cwd, windowsPaths) {
let result; let result;
try { try {
result = await exec(command, args, { cwd }); result = await exec(command, args, options.cwd === undefined ? {} : { cwd: options.cwd });
} catch { } catch {
return null; continue;
} }
if (!result || result.code !== 0) return null; if (!result || result.code !== 0) continue;
return String(result.stdout ?? "") const found = [];
.split("\n") for (const line of String(result.stdout ?? "").split("\n")) {
.map((line) => { const match = /^(\d+)\t(.+)$/.exec(line.replace(/\r$/, ""));
const path = line.trim(); if (match) found.push({ index: Number(match[1]), path: slashes(match[2]).trim() });
// PowerShell writes the separators of its own platform. }
return windowsPaths ? path.replace(/\\/g, "/") : path; return { shell: command, found };
}) }
.filter(Boolean); throw new Error(
relative ? "nie udało się wczytać katalogu projektu" : "nie udało się wczytać katalogu globalnego",
);
} }
/** /**
@@ -0,0 +1,292 @@
// dock.js - the model of the dock: the buttons next to the composer that send
// or insert a text kept by the person.
//
// Pure: no gpui-kit, gpui-base or herdr imports. Every function returns a new
// list and leaves its input alone. storage.js keeps the list under
// `herdr-composer.dock` and runs it through `normalize`.
/**
* @typedef {object} DockButton
* @property {string} id
* @property {string} label
* @property {string} text
* @property {"send"|"insert"} mode
*
* @typedef {object} MenuItem
* @property {string} command
* @property {string} label
* @property {boolean} [disabled]
* @property {boolean} [danger]
*/
/** How many buttons the dock holds. */
export const DOCK_LIMIT = 30;
/** The longest default label: 15 characters and an ellipsis. */
export const LABEL_MAX = 16;
const MODES = new Set(["send", "insert"]);
/**
* The label a button gets when the person gave none: the text with white
* space folded into single spaces, cut to LABEL_MAX characters.
*
* @param {string} text
* @returns {string}
*/
export function defaultLabel(text) {
const folded = String(text).replace(/\s+/g, " ").trim();
const chars = Array.from(folded);
return chars.length > LABEL_MAX ? `${chars.slice(0, LABEL_MAX - 1).join("")}…` : folded;
}
/**
* Keep what is a button: `id` and `text` not empty, a known `mode`. An empty
* label becomes the default one. A text that is already there (compared after
* `trim()`) is dropped - the first wins - and the list is cut to DOCK_LIMIT.
*
* @param {unknown} raw
* @returns {DockButton[]}
*/
export function normalize(raw) {
if (!Array.isArray(raw)) return [];
/** @type {DockButton[]} */
const out = [];
const seen = new Set();
const ids = new Set();
for (const item of raw) {
if (out.length >= DOCK_LIMIT) break;
if (!item || typeof item !== "object" || Array.isArray(item)) continue;
const { id, label, text, mode } = /** @type {Record<string, unknown>} */ (item);
if (typeof id !== "string" || id === "") continue;
if (typeof text !== "string" || text.trim() === "") continue;
if (typeof mode !== "string" || !MODES.has(mode)) continue;
const key = text.trim();
if (seen.has(key) || ids.has(id)) continue;
seen.add(key);
ids.add(id);
out.push({
id,
label: typeof label === "string" && label.trim() !== "" ? label.trim() : defaultLabel(text),
text,
mode: /** @type {"send"|"insert"} */ (mode),
});
}
return out;
}
/**
* @param {DockButton[]} dock
* @param {string} text
* @returns {boolean}
*/
export function isPinned(dock, text) {
const key = String(text).trim();
return dock.some((button) => button.text.trim() === key);
}
/**
* Add a button at the end. The same dock comes back when the text is empty,
* already pinned, or the dock is full.
*
* @param {DockButton[]} dock
* @param {string} text
* @param {string} id
* @returns {DockButton[]}
*/
export function pin(dock, text, id) {
const clean = String(text).trim();
if (clean === "" || isPinned(dock, clean) || dock.length >= DOCK_LIMIT) return dock;
return [...dock, { id, label: defaultLabel(clean), text: clean, mode: "send" }];
}
/**
* @param {DockButton[]} dock
* @param {string} text
* @returns {DockButton[]}
*/
export function unpin(dock, text) {
const key = String(text).trim();
return dock.filter((button) => button.text.trim() !== key);
}
/**
* @param {DockButton[]} dock
* @param {string} id
* @returns {DockButton[]}
*/
export function remove(dock, id) {
return dock.filter((button) => button.id !== id);
}
/**
* Move a button one place; at the edge nothing changes.
*
* @param {DockButton[]} dock
* @param {string} id
* @param {-1|1} step
* @returns {DockButton[]}
*/
export function move(dock, id, step) {
const from = dock.findIndex((button) => button.id === id);
const to = from + step;
if (from < 0 || to < 0 || to >= dock.length) return [...dock];
const out = [...dock];
[out[from], out[to]] = [out[to], out[from]];
return out;
}
/**
* An empty name (after `trim()`) gives the default label back.
*
* @param {DockButton[]} dock
* @param {string} id
* @param {string} label
* @returns {DockButton[]}
*/
export function rename(dock, id, label) {
const clean = String(label).trim();
return dock.map((button) =>
button.id === id ? { ...button, label: clean === "" ? defaultLabel(button.text) : clean } : button,
);
}
/**
* @param {DockButton[]} dock
* @param {string} id
* @returns {DockButton[]}
*/
export function toggleMode(dock, id) {
return dock.map((button) =>
button.id === id ? { ...button, mode: button.mode === "send" ? "insert" : "send" } : button,
);
}
/**
* What a click on a button does. Sending needs an agent; inserting does not.
*
* @param {{mode: "send"|"insert"}} button
* @param {{hasAgent: boolean}} context
* @returns {"send"|"insert"|"none"}
*/
export function dockAction(button, { hasAgent }) {
if (button.mode === "insert") return "insert";
return hasAgent ? "send" : "none";
}
/**
* The right-click menu of a button.
*
* @param {DockButton[]} dock
* @param {string} id
* @returns {MenuItem[]}
*/
export function dockMenu(dock, id) {
const index = dock.findIndex((button) => button.id === id);
const button = dock[index];
return [
{ command: "rename", label: "Zmień nazwę" },
{ command: "mode", label: button && button.mode === "insert" ? "Wysyłaj od razu" : "Tylko wstawiaj" },
{ command: "left", label: "Przesuń w lewo", disabled: index <= 0 },
{ command: "right", label: "Przesuń w prawo", disabled: index < 0 || index >= dock.length - 1 },
{ command: "remove", label: "Usuń z docka", danger: true },
];
}
/**
* The right-click menu of a row of the history or the favourites.
*
* @param {{tab: "history"|"favorites", favorite: boolean, pinned: boolean}} row
* @returns {MenuItem[]}
*/
export function rowMenu({ tab, favorite, pinned }) {
/** @type {MenuItem[]} */
const items = [{ command: "insert", label: "Wstaw" }];
if (tab === "favorites") {
items.push({ command: "pin", label: pinned ? "Odepnij z docka" : "Przypnij do docka" });
}
items.push(
favorite
? { command: "favorite", label: "Usuń z ulubionych", danger: true }
: { command: "favorite", label: "Dodaj do ulubionych" },
);
return items;
}
/**
* The right-click menu of the star: pin the text that is in the field.
*
* @param {{text: string, pinned: boolean}} state
* @returns {MenuItem[]}
*/
export function starMenu({ text, pinned }) {
return [
{
command: "pin",
label: pinned ? "Odepnij bieżący tekst z docka" : "Przypnij bieżący tekst do docka",
disabled: String(text).trim() === "",
},
];
}
/**
* The menu that is open after a `Popover` said it opened or closed.
*
* Opening always opens that menu (the one before it, if any, is replaced).
* Closing only closes the menu it is about: a late "closed" of a menu that
* another one has replaced must leave the new one open.
*
* @param {{kind: string, id: string}|null} current
* @param {{kind: string, id: string, open: boolean}} change
* @returns {{kind: string, id: string}|null}
*/
export function menuTransition(current, { kind, id, open }) {
if (open) return { kind, id };
return current && current.kind === kind && current.id === id ? null : current;
}
/**
* Apply one change to the dock as it is stored now. The dock is shared by
* every copy of the composer, so a copy never writes back the list it holds:
* it reads the stored one, applies the operation to it and writes the result.
*
* @param {unknown} stored
* @param {(dock: DockButton[]) => DockButton[]} operation
* @returns {DockButton[]}
*/
export function applyDock(stored, operation) {
return normalize(operation(normalize(stored)));
}
/**
* Add a button made by hand (the "+" form): the text, a name (empty gives the
* default label) and a mode. The same dock comes back when the text is empty,
* already pinned, or the dock is full.
*
* @param {DockButton[]} dock
* @param {{id: string, text: string, label?: string, mode?: string}} button
* @returns {DockButton[]}
*/
export function add(dock, { id, text, label, mode }) {
const clean = String(text).trim();
if (clean === "" || isPinned(dock, clean) || dock.length >= DOCK_LIMIT) return dock;
const name = String(label ?? "").trim();
return [
...dock,
{ id, label: name === "" ? defaultLabel(clean) : name, text: clean, mode: mode === "insert" ? "insert" : "send" },
];
}
/**
* True while `now` is less than `ms` after `at`: the click that closed
* something is still the same click.
*
* @param {number} now
* @param {number} at
* @param {number} ms
* @returns {boolean}
*/
export function withinGuard(now, at, ms) {
return now - at < ms;
}
File diff suppressed because it is too large. Load diff
@@ -9,8 +9,10 @@
// Limit of the list: rows of a `v_virtual_list` cannot carry their own click // Limit of the list: rows of a `v_virtual_list` cannot carry their own click
// handlers (the host refuses a handler inside the item renderer) - one // handlers (the host refuses a handler inside the item renderer) - one
// `on_item_click` serves the whole list and names the row by its key. So a row // `on_item_click` serves the whole list and names the row by its key. So a row
// click inserts the text; the star of a row is a sign, not a button (the // click inserts the text. The star of a row is not an element with a handler
// favourites are toggled with Ctrl+D or a right click - `on_item_secondary_click`). // either: `on_mouse_down` on the list says where the press landed, and a press
// in the STAR_ZONE at the right edge makes the click toggle the favourite
// (main.js). Ctrl+D and the right-click menu do the same.
import { div, image } from "gpui-kit"; import { div, image } from "gpui-kit";
import { v_flex, h_flex, Input, Scrollbar, v_virtual_list } from "gpui-base"; import { v_flex, h_flex, Input, Scrollbar, v_virtual_list } from "gpui-base";
@@ -25,6 +27,12 @@ import { segments, entryMeta } from "./history.js";
*/ */
export const ROW_HEIGHT = 76; export const ROW_HEIGHT = 76;
/**
* The right edge of a row that counts as its star: 10 px of padding, the
* 24 px star and a little room (a click lands next to a small target).
*/
export const STAR_ZONE = 48;
/** Two lines of the text of a row, at about 20 px a line (the rest is cut). */ /** Two lines of the text of a row, at about 20 px a line (the rest is cut). */
const TEXT_HEIGHT = 40; const TEXT_HEIGHT = 40;
@@ -47,7 +55,8 @@ const TEXT_HEIGHT = 40;
* key: (event:any, cx:any) => void, * key: (event:any, cx:any) => void,
* tab: (tab:string, cx:any) => void, * tab: (tab:string, cx:any) => void,
* pick: (key:string, cx:any) => void, * pick: (key:string, cx:any) => void,
* toggle: (key:string, cx:any) => void, * rowMenu: (key:string, cx:any) => void,
* press: (event:any) => void,
* clear: (cx:any) => void, * clear: (cx:any) => void,
* close: (cx:any) => void, * close: (cx:any) => void,
* }} on * }} on
@@ -164,6 +173,7 @@ function renderList(t, view, on) {
return v_flex() return v_flex()
.size_full() .size_full()
.relative() .relative()
.on_mouse_down("left", (event, cx) => on.press(event))
.child( .child(
v_virtual_list( v_virtual_list(
"composer-panel-list", "composer-panel-list",
@@ -175,7 +185,7 @@ function renderList(t, view, on) {
.track_scroll(view.scroll) .track_scroll(view.scroll)
.size_full() .size_full()
.on_item_click((key, cx) => on.pick(key, cx)) .on_item_click((key, cx) => on.pick(key, cx))
.on_item_secondary_click((key, event, cx) => on.toggle(key, cx)), .on_item_secondary_click((key, event, cx) => on.rowMenu(key, cx)),
) )
.child(Scrollbar.vertical("composer-panel-list").absolute().inset_0()); .child(Scrollbar.vertical("composer-panel-list").absolute().inset_0());
} }
@@ -0,0 +1,188 @@
// profiles.js - what the composer knows about each agent.
//
// Pure: no GPUI, no herdr, no IO. A profile says which `agentName()` values
// belong to an agent, its built-in commands and where its own commands live
// (a folder of the project and a folder of the person's home). The defaults
// are here; the person adds or replaces profiles in `composer-agents.json`.
// A profile of the file with the id of a default one replaces it whole.
//
// Source = {scope:"project"|"home", path, pattern:"*.md"|"*/SKILL.md", prefix}
// | {scope:"home", kind:"claude-plugins"}
// Profile = {id, match:string[], builtins:{key, desc}[], sources:Source[]}
/** The file the person's profiles live in, in the app's home folder. */
export const PROFILES_FILE = "composer-agents.json";
/**
* The built-in commands of the agents. The list is kept by hand, in the
* alphabetical order: when a new version of Claude Code brings a command,
* add it here.
*/
export const BUILTINS = {
"claude-code": [
{ key: "add-dir", desc: "Dodaje katalog roboczy." },
{ key: "agents", desc: "Zarządza subagentami." },
{ key: "bashes", desc: "Pokazuje zadania w tle." },
{ key: "bug", desc: "Zgłasza błąd Claude Code." },
{ key: "clear", desc: "Czyści historię rozmowy." },
{ key: "code-review", desc: "Przegląd zmian pod kątem błędów." },
{ key: "compact", desc: "Zwija historię do podsumowania." },
{ key: "config", desc: "Otwiera ustawienia." },
{ key: "context", desc: "Pokazuje zużycie kontekstu." },
{ key: "cost", desc: "Pokazuje koszt i zużycie tokenów." },
{ key: "doctor", desc: "Sprawdza instalację Claude Code." },
{ key: "exit", desc: "Kończy sesję." },
{ key: "export", desc: "Eksportuje rozmowę." },
{ key: "fast", desc: "Przełącza tryb szybki." },
{ key: "feedback", desc: "Wysyła opinię o Claude Code." },
{ key: "fewer-permission-prompts", desc: "Dodaje bezpieczne komendy do listy dozwolonych." },
{ key: "help", desc: "Pomoc." },
{ key: "hooks", desc: "Zarządza hookami." },
{ key: "ide", desc: "Łączy z IDE." },
{ key: "init", desc: "Tworzy CLAUDE.md dla projektu." },
{ key: "install-github-app", desc: "Instaluje aplikację GitHub." },
{ key: "keybindings", desc: "Ustawia skróty klawiszowe." },
{ key: "login", desc: "Logowanie." },
{ key: "logout", desc: "Wylogowanie." },
{ key: "loop", desc: "Uruchamia polecenie cyklicznie." },
{ key: "mcp", desc: "Zarządza serwerami MCP." },
{ key: "memory", desc: "Edytuje pliki pamięci." },
{ key: "model", desc: "Wybiera model." },
{ key: "output-style", desc: "Ustawia styl odpowiedzi." },
{ key: "permissions", desc: "Ustawia uprawnienia narzędzi." },
{ key: "plugin", desc: "Zarządza pluginami." },
{ key: "pr-comments", desc: "Pokazuje komentarze PR." },
{ key: "privacy-settings", desc: "Ustawienia prywatności." },
{ key: "release-notes", desc: "Pokazuje informacje o wydaniu." },
{ key: "resume", desc: "Wznawia wcześniejszą sesję." },
{ key: "review", desc: "Przegląd pull requesta." },
{ key: "rewind", desc: "Cofa rozmowę lub kod." },
{ key: "schedule", desc: "Planuje zadania w chmurze." },
{ key: "security-review", desc: "Przegląd bezpieczeństwa zmian." },
{ key: "simplify", desc: "Upraszcza zmieniony kod." },
{ key: "status", desc: "Pokazuje stan sesji." },
{ key: "statusline", desc: "Ustawia linię statusu." },
{ key: "terminal-setup", desc: "Konfiguruje terminal." },
{ key: "todos", desc: "Pokazuje listę zadań." },
{ key: "upgrade", desc: "Zmienia plan." },
{ key: "usage", desc: "Pokazuje limity użycia." },
{ key: "vim", desc: "Przełącza tryb vim." },
{ key: "workflows", desc: "Pokazuje przebieg workflow." },
],
codex: [
{ key: "model", desc: "Wybiera model." },
{ key: "approvals", desc: "Ustawia sposób zatwierdzania poleceń." },
{ key: "new", desc: "Zaczyna nową sesję." },
{ key: "resume", desc: "Wznawia wcześniejszą sesję." },
],
};
const CC_SOURCES = [
{ scope: "project", path: ".claude/commands", pattern: "*.md", prefix: "/" },
{ scope: "project", path: ".claude/skills", pattern: "*/SKILL.md", prefix: "/" },
{ scope: "home", path: ".claude/commands", pattern: "*.md", prefix: "/" },
{ scope: "home", path: ".claude/skills", pattern: "*/SKILL.md", prefix: "/" },
{ scope: "home", kind: "claude-plugins" },
];
/** The profiles the composer brings. */
export const DEFAULT_PROFILES = [
{
id: "claude-code",
match: ["claude-code", "claude"],
builtins: BUILTINS["claude-code"],
sources: CC_SOURCES,
},
{ id: "codex", match: ["codex"], builtins: BUILTINS.codex, sources: [] },
];
const PATTERNS = new Set(["*.md", "*/SKILL.md"]);
/** A relative path with no `..` segment: absolute forms are not allowed. */
function safePath(path) {
if (typeof path !== "string" || path.trim() === "") return false;
if (/^[\\/]/.test(path) || /^[A-Za-z]:/.test(path)) return false;
return !path.split(/[\\/]/).includes("..");
}
/** One source, normalised, or `null` when it is not valid. */
function parseSource(raw) {
if (!raw || typeof raw !== "object") return null;
if (raw.scope === "home" && raw.kind === "claude-plugins") {
return { scope: "home", kind: "claude-plugins" };
}
if (raw.scope !== "project" && raw.scope !== "home") return null;
if (!safePath(raw.path) || !PATTERNS.has(raw.pattern)) return null;
const prefix = typeof raw.prefix === "string" ? raw.prefix : "/";
const path = raw.path.replace(/\\/g, "/").replace(/\/+$/, "");
return { scope: raw.scope, path, pattern: raw.pattern, prefix };
}
/**
* The profiles of the person's file.
*
* @param {string|null|undefined} text - the file, `null` when it is missing
* @returns {{profiles: object[], problem: string|null}}
*/
export function parseProfiles(text) {
if (text === null || text === undefined) return { profiles: [], problem: null };
let data;
try {
data = JSON.parse(String(text).replace(/^\uFEFF/, ""));
} catch {
return { profiles: [], problem: "nieczytelny JSON" };
}
if (!data || !Array.isArray(data.agents)) return { profiles: [], problem: "brak listy agents" };
let skipped = 0;
const profiles = [];
for (const raw of data.agents) {
const match = Array.isArray(raw?.match) ? raw.match : null;
if (
!raw ||
typeof raw.id !== "string" ||
raw.id.trim() === "" ||
!match ||
match.length === 0 ||
!match.every((m) => typeof m === "string")
) {
skipped++;
continue;
}
const builtins = [];
for (const b of Array.isArray(raw.builtins) ? raw.builtins : []) {
if (!b || typeof b.key !== "string" || b.key === "") {
skipped++;
continue;
}
builtins.push({ key: b.key, desc: typeof b.desc === "string" ? b.desc : "" });
}
const sources = [];
for (const s of Array.isArray(raw.sources) ? raw.sources : []) {
const source = parseSource(s);
if (source) sources.push(source);
else skipped++;
}
profiles.push({ id: raw.id, match: match.map((m) => m.trim()), builtins, sources });
}
return { profiles, problem: skipped > 0 ? `pominięto ${skipped} wpisów` : null };
}
/**
* The profile of an agent: the person's first, then the defaults. `""` and
* `"default"` match nothing unless a profile lists them.
*
* @param {object[]} userProfiles
* @param {string} agent - `agentName()` of the pane
* @returns {object|null}
*/
export function resolveProfile(userProfiles, agent) {
const name = String(agent ?? "").trim().toLowerCase();
for (const profile of [...(userProfiles ?? []), ...DEFAULT_PROFILES]) {
if (profile.match.some((m) => String(m).trim().toLowerCase() === name)) return profile;
}
return null;
}
@@ -47,6 +47,8 @@
* @property {string} text * @property {string} text
* @property {number} createdAt * @property {number} createdAt
* *
* @typedef {import("./dock.js").DockButton} DockButton
*
* @typedef {object} QueueEntry * @typedef {object} QueueEntry
* @property {string} id * @property {string} id
* @property {string} text * @property {string} text
@@ -56,6 +58,8 @@
* @property {string} [reason] * @property {string} [reason]
*/ */
import { normalize as normalizeDock } from "./dock.js";
/** The states a queue entry may be in (the ones state.js knows). */ /** The states a queue entry may be in (the ones state.js knows). */
const QUEUE_STATES = new Set(["queued", "countdown", "sending", "held", "uncertain"]); const QUEUE_STATES = new Set(["queued", "countdown", "sending", "held", "uncertain"]);
@@ -79,6 +83,8 @@ export const KEYS = {
queue: "herdr-composer.queue", queue: "herdr-composer.queue",
/** The draft is per agent: `herdr-composer.draft:<agent>`. */ /** The draft is per agent: `herdr-composer.draft:<agent>`. */
draft: "herdr-composer.draft", draft: "herdr-composer.draft",
/** The buttons of the dock (dock.js). New in herdr-composer: no legacy key. */
dock: "herdr-composer.dock",
}; };
/** How many entries the history keeps. */ /** How many entries the history keeps. */
@@ -139,6 +145,26 @@ export function saveFavorites(store, items) {
writeList(store, KEYS.favorites, items, FAVORITES_LIMIT, isFavoriteEntry, toFavoriteEntry); writeList(store, KEYS.favorites, items, FAVORITES_LIMIT, isFavoriteEntry, toFavoriteEntry);
} }
/**
* The buttons of the dock. Only what is a button comes back (dock.js
* `normalize`). The dock is new, so there is no `ovis-composer.dock` to read.
*
* @param {Store} store
* @returns {DockButton[]}
*/
export function loadDock(store) {
return normalizeDock(read(store, KEYS.dock));
}
/**
* @param {Store} store
* @param {DockButton[]} items
* @returns {void}
*/
export function saveDock(store, items) {
write(store, KEYS.dock, normalizeDock(items));
}
/** /**
* The queue of one agent - the messages that wait for their turn. * The queue of one agent - the messages that wait for their turn.
* *
@@ -14,7 +14,7 @@
* @typedef {object} Item * @typedef {object} Item
* @property {string} key - the name the needle is matched against * @property {string} key - the name the needle is matched against
* @property {string} desc - one line about the item * @property {string} desc - one line about the item
* @property {string} [group] - Wbudowane | Projekt | Użytkownik | Terminal * @property {string} [group] - Wbudowane | Projekt | Użytkownik | Pluginy | Z historii | Terminal
* @property {string} insert - the text put into the field ("/review ") * @property {string} insert - the text put into the field ("/review ")
* @property {number} [uses] - how often the person picked the item * @property {number} [uses] - how often the person picked the item
*/ */
@@ -25,11 +25,22 @@ export const GROUP_BUILTIN = "Wbudowane";
export const GROUP_PROJECT = "Projekt"; export const GROUP_PROJECT = "Projekt";
/** The person's own saved snippets. */ /** The person's own saved snippets. */
export const GROUP_USER = "Użytkownik"; export const GROUP_USER = "Użytkownik";
/** The commands of the plugins that are switched on. */
export const GROUP_PLUGIN = "Pluginy";
/** The commands that were sent to this agent before. */
export const GROUP_HISTORY = "Z historii";
/** The commands the terminal itself understands. */ /** The commands the terminal itself understands. */
export const GROUP_TERMINAL = "Terminal"; export const GROUP_TERMINAL = "Terminal";
/** The groups, in the order the menu shows them. */ /** The groups, in the order the menu shows them. */
export const GROUPS = [GROUP_BUILTIN, GROUP_PROJECT, GROUP_USER, GROUP_TERMINAL]; export const GROUPS = [
GROUP_BUILTIN,
GROUP_PROJECT,
GROUP_USER,
GROUP_PLUGIN,
GROUP_HISTORY,
GROUP_TERMINAL,
];
/** A name may start a word after one of these. */ /** A name may start a word after one of these. */
const BOUNDARY = new Set([":", "-", "_", ".", "/"]); const BOUNDARY = new Set([":", "-", "_", ".", "/"]);
Binary file not shown.

Before

Width:  |  Height:  |  Size: 810 KiB

After

Width:  |  Height:  |  Size: 928 KiB

+458
View File
@@ -0,0 +1,458 @@
import test from "node:test";
import assert from "node:assert/strict";
import {
BUILTINS,
commands,
globalCommands,
historyCommands,
menuNotes,
} from "../herdr/herdr-composer/mods/herdr-composer/catalog.js";
import {
DEFAULT_PROFILES,
resolveProfile,
} from "../herdr/herdr-composer/mods/herdr-composer/profiles.js";
import {
GROUPS,
GROUP_HISTORY,
GROUP_USER,
GROUP_PLUGIN,
} from "../herdr/herdr-composer/mods/herdr-composer/suggest.js";
const HOME = "C:/Users/Test";
const CC_PROFILE = DEFAULT_PROFILES[0];
const CC = CC_PROFILE.sources;
/**
* A fake machine: `files` maps a path to its text. `exec` answers the POSIX
* listing of catalog.js (powershell is "not installed"), `readText` reads.
*/
function machine(files, { listError = false } = {}) {
const exec = async (command, args) => {
if (command !== "sh") throw new Error("not found");
if (listError) return { code: 2, stdout: "", stderr: "boom" };
const rest = args.slice(3);
const lines = [];
for (let i = 0; i + 2 < rest.length; i += 3) {
const [index, kind, path] = rest.slice(i, i + 3);
for (const file of Object.keys(files)) {
const name = file.slice(file.lastIndexOf("/") + 1);
const dir = file.slice(0, file.lastIndexOf("/"));
if (kind === "file" && file === path) lines.push(`${index}\t${file}`);
if (kind === "md" && dir === path && name.endsWith(".md")) lines.push(`${index}\t${file}`);
if (kind === "skills" && name === "SKILL.md" && dir.slice(0, dir.lastIndexOf("/")) === path)
lines.push(`${index}\t${file}`);
}
}
return { code: 0, stdout: lines.join("\n"), stderr: "" };
};
const readText = async (path) => files[path] ?? null;
return { exec, readText };
}
const skill = (name, extra = "") => `---\nname: ${name}\ndescription: Opis ${name}\n${extra}---\nTreść\n`;
function plugins(enabled, installed) {
return {
[`${HOME}/.claude/settings.json`]: JSON.stringify({ enabledPlugins: enabled }),
[`${HOME}/.claude/plugins/installed_plugins.json`]: JSON.stringify({
version: 2,
plugins: Object.fromEntries(
Object.entries(installed).map(([id, path]) => [id, [{ installPath: path }]]),
),
}),
};
}
/**
* One fake machine for the project (relative paths, `cwd` given) and the
* person's home (absolute paths). It answers the POSIX scripts of catalog.js:
* the old fixed project listing, and the listing by (index, kind, path)
* triples; PowerShell is "not installed".
*/
function ccMachine(files) {
const inner = machine(files);
const match = (index, kind, path) => {
const lines = [];
for (const file of Object.keys(files)) {
const name = file.slice(file.lastIndexOf("/") + 1);
const dir = file.slice(0, file.lastIndexOf("/"));
if (kind === "file" && file === path) lines.push(`${index}\t${file}`);
if (kind === "md" && dir === path && name.endsWith(".md")) lines.push(`${index}\t${file}`);
if (kind === "skills" && name === "SKILL.md" && dir.slice(0, dir.lastIndexOf("/")) === path)
lines.push(`${index}\t${file}`);
}
return lines;
};
const exec = async (command, args, options = {}) => {
if (command !== "sh") throw new Error("not found");
const rest = args.slice(3);
// the new listing of a profile's project sources: the same triples
if (options.cwd && rest.length > 0 && rest.length % 3 === 0 && /^\d+$/.test(rest[0])) {
const lines = [];
for (let i = 0; i < rest.length; i += 3) lines.push(...match(rest[i], rest[i + 1], rest[i + 2]));
return { code: 0, stdout: lines.join("\n"), stderr: "" };
}
// the old fixed listing of the project
if (options.cwd && rest.length === 0) {
const stdout = Object.keys(files)
.filter((f) => /^\.claude\/(commands\/[^/]+\.md|skills\/[^/]+\/SKILL\.md)$/.test(f))
.join("\n");
return { code: 0, stdout, stderr: "" };
}
// a read of one file
if (rest.length === 1) {
const text = files[rest[0]];
return text === undefined ? { code: 1, stdout: "", stderr: "" } : { code: 0, stdout: text, stderr: "" };
}
return inner.exec(command, args, options);
};
return { exec, readText: inner.readText };
}
const CC_FILES = {
".claude/commands/a.md": "---\ndescription: Komenda a\n---\nTreść\n",
".claude/skills/s/SKILL.md": skill("inna"),
[`${HOME}/.claude/commands/handoff.md`]: "---\ndescription: Przekazanie\n---\nTreść\n",
...plugins({ "sp@official": true }, { "sp@official": "C:\\p\\sp" }),
"C:/p/sp/skills/brainstorming/SKILL.md": skill("brainstorming"),
};
const ccRow = (item) => ({ key: item.key, group: item.group, insert: item.insert, desc: item.desc });
test("GROUPS has Pluginy right after Użytkownik", () => {
assert.equal(GROUPS[GROUPS.indexOf(GROUP_USER) + 1], "Pluginy");
assert.equal(GROUP_PLUGIN, "Pluginy");
});
test("claude-code builtins: the full list, unique keys", () => {
const keys = BUILTINS["claude-code"].map((item) => item.key);
for (const key of ["context", "help", "mcp", "rewind", "clear"]) assert.ok(keys.includes(key), key);
assert.equal(new Set(keys).size, keys.length);
assert.deepEqual(keys, [...keys].sort());
});
test("globalCommands: an enabled plugin gives plugin:name (default skills dir)", async () => {
const dir = "C:/p/superpowers/7.0.2";
const { exec, readText } = machine({
...plugins({ "superpowers@official": true }, { "superpowers@official": "C:\\p\\superpowers\\7.0.2" }),
[`${dir}/skills/brainstorming/SKILL.md`]: skill("brainstorming"),
});
const items = await globalCommands(HOME, exec, readText, { sources: CC });
assert.equal(items.length, 1);
assert.equal(items[0].key, "superpowers:brainstorming");
assert.equal(items[0].group, GROUP_PLUGIN);
assert.equal(items[0].insert, "/superpowers:brainstorming ");
assert.equal(items[0].desc, "Opis brainstorming");
});
test("globalCommands: disabled or unlisted plugin gives nothing", async () => {
const dir = "C:/p/a/1";
const { exec, readText } = machine({
...plugins({ "a@m": false }, { "a@m": dir, "b@m": "C:/p/b/1" }),
[`${dir}/skills/x/SKILL.md`]: skill("x"),
["C:/p/b/1/skills/y/SKILL.md"]: skill("y"),
});
assert.deepEqual(await globalCommands(HOME, exec, readText, { sources: CC }), []);
});
test("globalCommands: plugin.json skills array takes only the named dirs", async () => {
const dir = "C:/p/mp/1";
const { exec, readText } = machine({
...plugins({ "mp@m": true }, { "mp@m": dir }),
[`${dir}/.claude-plugin/plugin.json`]: JSON.stringify({ skills: ["./skills/eng/tdd"] }),
[`${dir}/skills/eng/tdd/SKILL.md`]: skill("tdd"),
[`${dir}/skills/eng/other/SKILL.md`]: skill("other"),
[`${dir}/skills/direct/SKILL.md`]: skill("direct"),
});
const keys = (await globalCommands(HOME, exec, readText, { sources: CC })).map((item) => item.key);
assert.deepEqual(keys, ["mp:tdd"]);
});
test("globalCommands: plugin commands dir and user-invocable false", async () => {
const dir = "C:/p/c/1";
const { exec, readText } = machine({
...plugins({ "c@m": true }, { "c@m": dir }),
[`${dir}/commands/ship.md`]: "---\ndescription: Wysyła\n---\n",
[`${dir}/skills/hidden/SKILL.md`]: skill("hidden", "user-invocable: false\n"),
[`${dir}/skills/shown/SKILL.md`]: skill("shown"),
});
const keys = (await globalCommands(HOME, exec, readText, { sources: CC })).map((item) => item.key).sort();
assert.deepEqual(keys, ["c:ship", "c:shown"]);
});
test("globalCommands: name: in the front matter wins over the folder name", async () => {
const { exec, readText } = machine({
[`${HOME}/.claude/skills/folder/SKILL.md`]: skill("real-name"),
});
const items = await globalCommands(HOME, exec, readText, { sources: CC });
assert.deepEqual(items.map((item) => item.key), ["real-name"]);
});
test("globalCommands: a user command gives handoff in Użytkownik", async () => {
const { exec, readText } = machine({
[`${HOME}/.claude/commands/handoff.md`]: "---\ndescription: Przekazanie\n---\n",
});
const items = await globalCommands(HOME, exec, readText, { sources: CC });
assert.equal(items.length, 1);
assert.equal(items[0].key, "handoff");
assert.equal(items[0].group, GROUP_USER);
assert.equal(items[0].insert, "/handoff ");
});
test("globalCommands: no settings.json, broken json: user items only, no throw", async () => {
const none = machine({ [`${HOME}/.claude/commands/a.md`]: "x" });
assert.deepEqual((await globalCommands(HOME, none.exec, none.readText, { sources: CC })).map((i) => i.key), ["a"]);
const broken = machine({
[`${HOME}/.claude/settings.json`]: "{nope",
[`${HOME}/.claude/plugins/installed_plugins.json`]: "[[",
[`${HOME}/.claude/commands/a.md`]: "x",
});
assert.deepEqual((await globalCommands(HOME, broken.exec, broken.readText, { sources: CC })).map((i) => i.key), ["a"]);
});
test("globalCommands: a listing failure goes to onReadError, or throws", async () => {
const { exec, readText } = machine({}, { listError: true });
const errors = [];
const items = await globalCommands(HOME, exec, readText, { sources: CC, onReadError: (err) => errors.push(err) });
assert.deepEqual(items, []);
assert.equal(errors.length, 1);
await assert.rejects(() => globalCommands(HOME, exec, readText, { sources: CC }));
});
test("paths with spaces and Polish letters are not put in the PowerShell script as text", async () => {
const home = "D:/Użytkownik Zażółć/x";
let script = "";
const exec = async (command, args) => {
if (command === "powershell") {
script = args[args.length - 1];
return { code: 0, stdout: "", stderr: "" };
}
throw new Error("no");
};
await globalCommands(home, exec, async () => null, { sources: CC });
assert.ok(script.length > 0);
assert.ok(!script.includes("Zażółć"));
});
test("commands: options.global joins after the project, first key wins", async () => {
const exec = async () => ({ code: 0, stdout: "", stderr: "" });
const global = [
{ key: "clear", desc: "dup", group: GROUP_USER, insert: "/clear " },
{ key: "handoff", desc: "h", group: GROUP_USER, insert: "/handoff " },
];
const items = await commands("/x", exec, { profile: CC_PROFILE, global });
assert.equal(items.filter((item) => item.key === "clear").length, 1);
assert.equal(
items.find((item) => item.key === "clear").desc,
BUILTINS["claude-code"].find((item) => item.key === "clear").desc,
);
assert.ok(items.some((item) => item.key === "handoff"));
});
test("commands: codex gets its builtins and snippets - no project sources, no exec", async () => {
let calls = 0;
const exec = async () => {
calls += 1;
return { code: 0, stdout: "", stderr: "" };
};
const items = await commands("/x", exec, {
profile: resolveProfile([], "codex"),
snippets: [{ key: "mine", desc: "s" }],
});
assert.equal(calls, 0);
const keys = items.map((item) => item.key);
assert.deepEqual(keys, [...BUILTINS.codex.map((item) => item.key), "mine"]);
});
test("commands: claude-code still reads the project and takes the global ones", async () => {
const { exec } = ccMachine({ ".claude/commands/p.md": "x" });
const global = [{ key: "handoff", desc: "h", group: GROUP_USER, insert: "/handoff " }];
const items = await commands("/x", exec, { profile: resolveProfile([], "claude"), global });
const keys = items.map((item) => item.key);
assert.ok(keys.includes("handoff"));
assert.ok(keys.includes("clear"));
});
const EXPECTED_CC = [
{"key":"add-dir","group":"Wbudowane","insert":"/add-dir ","desc":"Dodaje katalog roboczy."},
{"key":"agents","group":"Wbudowane","insert":"/agents ","desc":"Zarządza subagentami."},
{"key":"bashes","group":"Wbudowane","insert":"/bashes ","desc":"Pokazuje zadania w tle."},
{"key":"bug","group":"Wbudowane","insert":"/bug ","desc":"Zgłasza błąd Claude Code."},
{"key":"clear","group":"Wbudowane","insert":"/clear ","desc":"Czyści historię rozmowy."},
{"key":"code-review","group":"Wbudowane","insert":"/code-review ","desc":"Przegląd zmian pod kątem błędów."},
{"key":"compact","group":"Wbudowane","insert":"/compact ","desc":"Zwija historię do podsumowania."},
{"key":"config","group":"Wbudowane","insert":"/config ","desc":"Otwiera ustawienia."},
{"key":"context","group":"Wbudowane","insert":"/context ","desc":"Pokazuje zużycie kontekstu."},
{"key":"cost","group":"Wbudowane","insert":"/cost ","desc":"Pokazuje koszt i zużycie tokenów."},
{"key":"doctor","group":"Wbudowane","insert":"/doctor ","desc":"Sprawdza instalację Claude Code."},
{"key":"exit","group":"Wbudowane","insert":"/exit ","desc":"Kończy sesję."},
{"key":"export","group":"Wbudowane","insert":"/export ","desc":"Eksportuje rozmowę."},
{"key":"fast","group":"Wbudowane","insert":"/fast ","desc":"Przełącza tryb szybki."},
{"key":"feedback","group":"Wbudowane","insert":"/feedback ","desc":"Wysyła opinię o Claude Code."},
{"key":"fewer-permission-prompts","group":"Wbudowane","insert":"/fewer-permission-prompts ","desc":"Dodaje bezpieczne komendy do listy dozwolonych."},
{"key":"help","group":"Wbudowane","insert":"/help ","desc":"Pomoc."},
{"key":"hooks","group":"Wbudowane","insert":"/hooks ","desc":"Zarządza hookami."},
{"key":"ide","group":"Wbudowane","insert":"/ide ","desc":"Łączy z IDE."},
{"key":"init","group":"Wbudowane","insert":"/init ","desc":"Tworzy CLAUDE.md dla projektu."},
{"key":"install-github-app","group":"Wbudowane","insert":"/install-github-app ","desc":"Instaluje aplikację GitHub."},
{"key":"keybindings","group":"Wbudowane","insert":"/keybindings ","desc":"Ustawia skróty klawiszowe."},
{"key":"login","group":"Wbudowane","insert":"/login ","desc":"Logowanie."},
{"key":"logout","group":"Wbudowane","insert":"/logout ","desc":"Wylogowanie."},
{"key":"loop","group":"Wbudowane","insert":"/loop ","desc":"Uruchamia polecenie cyklicznie."},
{"key":"mcp","group":"Wbudowane","insert":"/mcp ","desc":"Zarządza serwerami MCP."},
{"key":"memory","group":"Wbudowane","insert":"/memory ","desc":"Edytuje pliki pamięci."},
{"key":"model","group":"Wbudowane","insert":"/model ","desc":"Wybiera model."},
{"key":"output-style","group":"Wbudowane","insert":"/output-style ","desc":"Ustawia styl odpowiedzi."},
{"key":"permissions","group":"Wbudowane","insert":"/permissions ","desc":"Ustawia uprawnienia narzędzi."},
{"key":"plugin","group":"Wbudowane","insert":"/plugin ","desc":"Zarządza pluginami."},
{"key":"pr-comments","group":"Wbudowane","insert":"/pr-comments ","desc":"Pokazuje komentarze PR."},
{"key":"privacy-settings","group":"Wbudowane","insert":"/privacy-settings ","desc":"Ustawienia prywatności."},
{"key":"release-notes","group":"Wbudowane","insert":"/release-notes ","desc":"Pokazuje informacje o wydaniu."},
{"key":"resume","group":"Wbudowane","insert":"/resume ","desc":"Wznawia wcześniejszą sesję."},
{"key":"review","group":"Wbudowane","insert":"/review ","desc":"Przegląd pull requesta."},
{"key":"rewind","group":"Wbudowane","insert":"/rewind ","desc":"Cofa rozmowę lub kod."},
{"key":"schedule","group":"Wbudowane","insert":"/schedule ","desc":"Planuje zadania w chmurze."},
{"key":"security-review","group":"Wbudowane","insert":"/security-review ","desc":"Przegląd bezpieczeństwa zmian."},
{"key":"simplify","group":"Wbudowane","insert":"/simplify ","desc":"Upraszcza zmieniony kod."},
{"key":"status","group":"Wbudowane","insert":"/status ","desc":"Pokazuje stan sesji."},
{"key":"statusline","group":"Wbudowane","insert":"/statusline ","desc":"Ustawia linię statusu."},
{"key":"terminal-setup","group":"Wbudowane","insert":"/terminal-setup ","desc":"Konfiguruje terminal."},
{"key":"todos","group":"Wbudowane","insert":"/todos ","desc":"Pokazuje listę zadań."},
{"key":"upgrade","group":"Wbudowane","insert":"/upgrade ","desc":"Zmienia plan."},
{"key":"usage","group":"Wbudowane","insert":"/usage ","desc":"Pokazuje limity użycia."},
{"key":"vim","group":"Wbudowane","insert":"/vim ","desc":"Przełącza tryb vim."},
{"key":"workflows","group":"Wbudowane","insert":"/workflows ","desc":"Pokazuje przebieg workflow."},
{"key":"a","group":"Projekt","insert":"/a ","desc":"Komenda a"},
{"key":"s","group":"Projekt","insert":"/s ","desc":"Opis inna"},
{"key":"handoff","group":"Użytkownik","insert":"/handoff ","desc":"Przekazanie"},
{"key":"sp:brainstorming","group":"Pluginy","insert":"/sp:brainstorming ","desc":"Opis brainstorming"},
];
test("the / menu of Claude Code stays as it was", async () => {
const { exec, readText } = ccMachine(CC_FILES);
const global = await globalCommands(HOME, exec, readText, { sources: CC });
const items = await commands("/proj", exec, { profile: resolveProfile([], "claude-code"), global });
assert.deepEqual(items.map(ccRow), EXPECTED_CC);
});
test("commands: no profile gives only the history and the snippets, and no exec", async () => {
let calls = 0;
const exec = async () => {
calls += 1;
return { code: 0, stdout: "", stderr: "" };
};
const h = { key: "clear", desc: "", group: GROUP_HISTORY, insert: "/clear " };
assert.deepEqual(await commands("/x", exec, { profile: null, history: [h] }), [h]);
assert.equal(calls, 0);
});
test("commands: a profile project source with a prefix", async () => {
const profile = {
id: "kiro",
match: ["kiro-cli"],
builtins: [],
sources: [{ scope: "project", path: ".kiro/prompts", pattern: "*.md", prefix: "@" }],
};
const { exec } = ccMachine({ ".kiro/prompts/review.md": "---\ndescription: R\n---\n" });
const items = await commands("/x", exec, { profile });
assert.deepEqual(items, [
{ key: "review", desc: "R", group: "Projekt", insert: "@review " },
]);
});
test("commands: a project source path never reaches the shell as a script", async () => {
const seen = [];
const exec = async (command, args) => {
seen.push([command, args]);
return { code: 0, stdout: "", stderr: "" };
};
const profile = {
id: "x",
match: ["x"],
builtins: [],
sources: [{ scope: "project", path: ".a b/Zażółć", pattern: "*.md", prefix: "/" }],
};
await commands("/x", exec, { profile });
assert.equal(seen.length, 1);
assert.ok(!seen[0][1][1].includes("Zażółć"));
assert.ok(seen[0][1].includes(".a b/Zażółć"));
});
test("globalCommands: no sources gives [] and no exec", async () => {
let calls = 0;
const exec = async () => {
calls += 1;
return { code: 0, stdout: "", stderr: "" };
};
assert.deepEqual(await globalCommands(HOME, exec, async () => null, { sources: [] }), []);
assert.deepEqual(await globalCommands(HOME, exec, async () => null), []);
assert.equal(calls, 0);
});
test("globalCommands: a home source gives the Użytkownik group with its prefix", async () => {
const { exec, readText } = machine({ [`${HOME}/.kiro/prompts/plan.md`]: "---\ndescription: P\n---\n" });
const sources = [{ scope: "home", path: ".kiro/prompts", pattern: "*.md", prefix: "@" }];
const items = await globalCommands(HOME, exec, readText, { sources });
assert.deepEqual(items, [{ key: "plan", desc: "P", group: GROUP_USER, insert: "@plan " }]);
});
test("globalCommands: a project source is not read from home", async () => {
const { exec, readText } = machine({ [`${HOME}/.kiro/prompts/plan.md`]: "x" });
const sources = [{ scope: "project", path: ".kiro/prompts", pattern: "*.md", prefix: "/" }];
assert.deepEqual(await globalCommands(HOME, exec, readText, { sources }), []);
});
test("historyCommands: commands of this agent, newest first, no paths", () => {
const e = (text, sentAt, agentName = "claude-code") => ({ text, sentAt, agentName });
const history = [
e("/clear", 1),
e(" /superpowers:brainstorming x", 5),
e("/c/Users/x", 6),
e("/ cos", 7),
e("/", 8),
e("hej /clear", 9),
e("/other", 10, "codex"),
];
const items = historyCommands(history, "Claude-Code");
assert.deepEqual(items.map((i) => i.key), ["superpowers:brainstorming", "clear"]);
assert.ok(items.every((i) => i.group === "Z historii" && i.desc === ""));
assert.equal(items[0].insert, "/superpowers:brainstorming ");
});
test("commands: a history command that is a builtin shows once, as Wbudowane", async () => {
const exec = async () => ({ code: 0, stdout: "", stderr: "" });
const items = await commands("/x", exec, {
profile: resolveProfile([], "codex"),
history: historyCommands([{ text: "/model", sentAt: 1, agentName: "codex" }], "codex"),
});
const model = items.filter((i) => i.key === "model");
assert.equal(model.length, 1);
assert.equal(model[0].group, "Wbudowane");
});
test("GROUPS has Z historii right after Pluginy", () => {
assert.equal(GROUPS[GROUPS.indexOf("Pluginy") + 1], "Z historii");
});
test("menuNotes: an unknown agent names the key, but only once the file was read", () => {
const loaded = menuNotes({ profile: null, agent: "kiro-cli", profilesLoaded: true, problem: null });
assert.equal(loaded.length, 1);
assert.ok(loaded[0].includes("`kiro-cli`"));
assert.ok(loaded[0].includes("composer-agents.json"));
assert.deepEqual(menuNotes({ profile: null, agent: "kiro-cli", profilesLoaded: false, problem: null }), []);
});
test("menuNotes: a problem with the file is one row", () => {
assert.deepEqual(
menuNotes({ profile: CC_PROFILE, agent: "claude", profilesLoaded: true, problem: "nieczytelny JSON" }),
["`composer-agents.json`: nieczytelny JSON"],
);
});
test("menuNotes: unknown agent first, then the problem", () => {
const notes = menuNotes({ profile: null, agent: "kiro-cli", profilesLoaded: true, problem: "brak listy agents" });
assert.equal(notes.length, 2);
assert.ok(notes[0].startsWith("Nieznany agent"));
assert.equal(notes[1], "`composer-agents.json`: brak listy agents");
});
+178
View File
@@ -0,0 +1,178 @@
import test from "node:test";
import assert from "node:assert/strict";
import {
DOCK_LIMIT, LABEL_MAX, defaultLabel, normalize, isPinned, pin, unpin, remove, move,
rename, toggleMode, dockAction, dockMenu, rowMenu, starMenu, menuTransition, applyDock, add, withinGuard,
} from "../herdr/herdr-composer/mods/herdr-composer/dock.js";
const btn = (id, text, extra = {}) => ({ id, label: text, text, mode: "send", ...extra });
const three = () => [btn("1", "a"), btn("2", "b"), btn("3", "c")];
test("limits", () => {
assert.equal(DOCK_LIMIT, 30);
assert.equal(LABEL_MAX, 16);
});
test("defaultLabel", () => {
assert.equal(defaultLabel("/handoff"), "/handoff");
assert.equal(defaultLabel("npm test i raport po polsku"), "npm test i rapo…");
assert.equal(defaultLabel(" a\n b "), "a b");
});
test("normalize: rubbish, bad modes, duplicates, label", () => {
assert.deepEqual(normalize("x"), []);
assert.deepEqual(normalize(null), []);
const out = normalize([
{ id: "1", text: "a", mode: "send", label: "" },
{ id: "2", text: " a ", mode: "send", label: "x" },
{ id: "3", text: "b", mode: "zly" },
]);
assert.deepEqual(out, [{ id: "1", label: "a", text: "a", mode: "send" }]);
});
test("normalize: limit 30", () => {
const raw = Array.from({ length: 35 }, (_, i) => ({ id: `i${i}`, text: `t${i}`, mode: "send", label: "l" }));
assert.equal(normalize(raw).length, 30);
});
test("pin", () => {
const d = pin([], " /clear ", "9");
assert.deepEqual(d, [{ id: "9", label: "/clear", text: "/clear", mode: "send" }]);
assert.equal(pin(d, "/clear", "10"), d);
assert.equal(pin(d, " ", "x"), d);
const full = Array.from({ length: 30 }, (_, i) => btn(`i${i}`, `t${i}`));
assert.equal(pin(full, "new", "n"), full);
assert.equal(isPinned(d, " /clear "), true);
assert.equal(isPinned(d, "other"), false);
});
test("unpin and remove", () => {
const d = three();
assert.deepEqual(unpin(d, " b ").map((b) => b.id), ["1", "3"]);
assert.deepEqual(remove(d, "1").map((b) => b.id), ["2", "3"]);
assert.equal(d.length, 3);
});
test("move: edge no change, swap, no mutation", () => {
const d = three();
const copy = JSON.parse(JSON.stringify(d));
assert.deepEqual(move(d, "1", -1).map((b) => b.id), ["1", "2", "3"]);
assert.deepEqual(move(d, "3", 1).map((b) => b.id), ["1", "2", "3"]);
assert.deepEqual(move(d, "1", 1).map((b) => b.id), ["2", "1", "3"]);
assert.deepEqual(d, copy);
});
test("rename and toggleMode", () => {
const d = three();
assert.equal(rename(d, "1", " ")[0].label, defaultLabel("a"));
assert.equal(rename(d, "1", " Moje ")[0].label, "Moje");
assert.equal(d[0].label, "a");
const once = toggleMode(d, "1");
assert.equal(once[0].mode, "insert");
assert.equal(toggleMode(once, "1")[0].mode, "send");
assert.equal(d[0].mode, "send");
});
test("dockAction", () => {
assert.equal(dockAction({ mode: "insert" }, { hasAgent: true }), "insert");
assert.equal(dockAction({ mode: "send" }, { hasAgent: true }), "send");
assert.equal(dockAction({ mode: "send" }, { hasAgent: false }), "none");
});
test("dockMenu", () => {
const d = three();
const m = dockMenu(d, "1");
assert.deepEqual(m.map((i) => i.command), ["rename", "mode", "left", "right", "remove"]);
assert.equal(m[0].label, "Zmień nazwę");
assert.equal(m[1].label, "Tylko wstawiaj");
assert.equal(m[2].label, "Przesuń w lewo");
assert.equal(m[2].disabled, true);
assert.notEqual(m[3].disabled, true);
assert.equal(m[4].label, "Usuń z docka");
assert.equal(m[4].danger, true);
const last = dockMenu(d, "3");
assert.equal(last[3].disabled, true);
const ins = dockMenu(toggleMode(d, "2"), "2");
assert.equal(ins[1].label, "Wysyłaj od razu");
});
test("rowMenu", () => {
const h = rowMenu({ tab: "history", favorite: false, pinned: false });
assert.deepEqual(h.map((i) => i.command), ["insert", "favorite"]);
assert.equal(h[0].label, "Wstaw");
assert.equal(h[1].label, "Dodaj do ulubionych");
const f = rowMenu({ tab: "favorites", favorite: true, pinned: true });
assert.deepEqual(f.map((i) => i.command), ["insert", "pin", "favorite"]);
assert.equal(f[1].label, "Odepnij z docka");
assert.equal(f[2].label, "Usuń z ulubionych");
assert.equal(f[2].danger, true);
const g = rowMenu({ tab: "favorites", favorite: true, pinned: false });
assert.equal(g[1].label, "Przypnij do docka");
});
test("starMenu", () => {
assert.equal(starMenu({ text: "", pinned: false })[0].disabled, true);
assert.equal(starMenu({ text: " ", pinned: false })[0].disabled, true);
const on = starMenu({ text: "x", pinned: false });
assert.equal(on[0].command, "pin");
assert.equal(on[0].label, "Przypnij bieżący tekst do docka");
assert.notEqual(on[0].disabled, true);
assert.equal(starMenu({ text: "x", pinned: true })[0].label, "Odepnij bieżący tekst z docka");
});
test("normalize: duplicate ids dropped (first wins), labels trimmed", () => {
const out = normalize([
{ id: "1", text: "a", mode: "send", label: " Moje " },
{ id: "1", text: "b", mode: "send", label: "x" },
{ id: "2", text: "c", mode: "send", label: " " },
]);
assert.deepEqual(out, [
{ id: "1", label: "Moje", text: "a", mode: "send" },
{ id: "2", label: "c", text: "c", mode: "send" },
]);
});
test("menuTransition: open replaces, close only closes its own menu", () => {
const A = { kind: "dock", id: "A" };
const B = { kind: "dock", id: "B" };
assert.deepEqual(menuTransition(null, { ...A, open: true }), A);
// open A, a command (menu closed), open B -> B is open
let state = menuTransition(null, { ...A, open: true });
state = null;
assert.deepEqual(menuTransition(state, { ...B, open: true }), B);
// open A, then open B, then the late close of A -> B stays
state = menuTransition(A, { ...B, open: true });
assert.deepEqual(menuTransition(state, { ...A, open: false }), B);
// close of the open one closes; a close with nothing open stays null
assert.equal(menuTransition(B, { ...B, open: false }), null);
assert.equal(menuTransition(null, { ...A, open: false }), null);
// same id, other kind is another menu
assert.deepEqual(menuTransition(B, { kind: "star", id: "B", open: false }), B);
});
test("applyDock: works on the stored list, so another copy's change survives", () => {
const stored = [btn("1", "a"), btn("2", "from-copy-A")];
// copy B held only ["a"]; it pins "b" - the result keeps A's pin
const out = applyDock(stored, (d) => pin(d, "b", "3"));
assert.deepEqual(out.map((b) => b.id), ["1", "2", "3"]);
assert.deepEqual(applyDock("rubbish", (d) => pin(d, "x", "9")).map((b) => b.id), ["9"]);
assert.deepEqual(applyDock(stored, (d) => remove(d, "1")).map((b) => b.id), ["2"]);
});
test("add: label, mode, empty text, duplicate, limit", () => {
const a = add([], { id: "1", text: " /handoff ", label: "", mode: "send" });
assert.deepEqual(a, [{ id: "1", label: "/handoff", text: "/handoff", mode: "send" }]);
const b = add(a, { id: "2", text: "npm test", label: " Testy ", mode: "insert" });
assert.deepEqual(b[1], { id: "2", label: "Testy", text: "npm test", mode: "insert" });
assert.equal(add(b, { id: "3", text: " ", label: "x", mode: "send" }), b);
assert.equal(add(b, { id: "3", text: "npm test", label: "x", mode: "send" }), b);
const full = Array.from({ length: DOCK_LIMIT }, (_, i) => btn(`f${i}`, `t${i}`));
assert.equal(add(full, { id: "n", text: "new", label: "", mode: "send" }), full);
assert.equal(add([], { id: "1", text: "x", label: "", mode: "bogus" })[0].mode, "send");
});
test("withinGuard: only just after the moment", () => {
assert.equal(withinGuard(1100, 1000, 250), true);
assert.equal(withinGuard(1250, 1000, 250), false);
assert.equal(withinGuard(5000, 0, 250), false);
});
+146
View File
@@ -0,0 +1,146 @@
import test from "node:test";
import assert from "node:assert/strict";
import {
BUILTINS,
DEFAULT_PROFILES,
PROFILES_FILE,
parseProfiles,
resolveProfile,
} from "../herdr/herdr-composer/mods/herdr-composer/profiles.js";
test("PROFILES_FILE is composer-agents.json", () => {
assert.equal(PROFILES_FILE, "composer-agents.json");
});
test("resolveProfile: defaults, case-insensitive, unknown and default are null", () => {
assert.equal(resolveProfile([], "claude").id, "claude-code");
assert.equal(resolveProfile([], "Claude-Code").id, "claude-code");
assert.equal(resolveProfile([], "codex").id, "codex");
assert.equal(resolveProfile([], "kiro-cli"), null);
assert.equal(resolveProfile([], "default"), null);
assert.equal(resolveProfile([], ""), null);
});
test("resolveProfile: match is case-insensitive for a user profile", () => {
const { profiles } = parseProfiles('{"agents":[{"id":"kiro","match":["kiro-cli"]}]}');
assert.equal(resolveProfile(profiles, "Kiro-CLI").id, "kiro");
assert.equal(resolveProfile(profiles, " kiro-cli ").id, "kiro");
});
test("resolveProfile: a user profile with the same id replaces the default whole", () => {
const { profiles } = parseProfiles(
'{"agents":[{"id":"claude-code","match":["claude-code"],"builtins":[{"key":"x"}]}]}',
);
const profile = resolveProfile(profiles, "claude-code");
assert.deepEqual(profile.builtins, [{ key: "x", desc: "" }]);
assert.deepEqual(profile.sources, []);
});
test("parseProfiles: no file is normal", () => {
assert.deepEqual(parseProfiles(null), { profiles: [], problem: null });
assert.deepEqual(parseProfiles(undefined), { profiles: [], problem: null });
});
test("parseProfiles: BOM and CRLF are fine, prefix kept", () => {
const text =
'\uFEFF{"agents":[{"id":"kiro","match":["kiro-cli"],"sources":[{"scope":"home","path":".kiro/prompts","pattern":"*.md","prefix":"@"}]}]}\r\n';
const { profiles, problem } = parseProfiles(text);
assert.equal(problem, null);
assert.equal(profiles.length, 1);
assert.deepEqual(profiles[0].sources, [
{ scope: "home", path: ".kiro/prompts", pattern: "*.md", prefix: "@" },
]);
});
test("parseProfiles: broken JSON", () => {
assert.deepEqual(parseProfiles("{nope"), { profiles: [], problem: "nieczytelny JSON" });
});
test("parseProfiles: agents is not a list", () => {
assert.deepEqual(parseProfiles('{"agents":{}}'), { profiles: [], problem: "brak listy agents" });
assert.deepEqual(parseProfiles("{}"), { profiles: [], problem: "brak listy agents" });
});
test("parseProfiles: bad sources are dropped, the good one stays", () => {
const text = JSON.stringify({
agents: [
{
id: "a",
match: ["a"],
sources: [
{ scope: "project", path: "../x", pattern: "*.md" },
{ scope: "home", path: "C:/x", pattern: "*.md" },
{ scope: "project", path: ".a/cmds", pattern: "*.md" },
],
},
],
});
const { profiles, problem } = parseProfiles(text);
assert.equal(profiles[0].sources.length, 1);
assert.equal(profiles[0].sources[0].prefix, "/");
assert.equal(problem, "pominięto 2 wpisów");
});
test("parseProfiles: absolute and traversal path forms are rejected", () => {
for (const path of ["/x", "C:/x", "C:\\x", "\\\\x", "a/../b", "a\\..\\b", ".."]) {
const text = JSON.stringify({
agents: [{ id: "a", match: ["a"], sources: [{ scope: "home", path, pattern: "*.md" }] }],
});
assert.deepEqual(parseProfiles(text).profiles[0].sources, [], path);
}
});
test("parseProfiles: a profile without match is dropped, the next stays", () => {
const text = JSON.stringify({ agents: [{ id: "bad" }, { id: "ok", match: ["ok"] }] });
const { profiles, problem } = parseProfiles(text);
assert.deepEqual(profiles.map((p) => p.id), ["ok"]);
assert.equal(problem, "pominięto 1 wpisów");
});
test("parseProfiles: unknown pattern, scope and keyless builtin are dropped", () => {
const text = JSON.stringify({
agents: [
{
id: "a",
match: ["a"],
builtins: [{ key: "ok", desc: "d" }, { desc: "no key" }],
sources: [
{ scope: "home", path: "p", pattern: "**/*.md" },
{ scope: "nowhere", path: "p", pattern: "*.md" },
],
},
],
});
const { profiles, problem } = parseProfiles(text);
assert.deepEqual(profiles[0].builtins, [{ key: "ok", desc: "d" }]);
assert.deepEqual(profiles[0].sources, []);
assert.equal(problem, "pominięto 3 wpisów");
});
test("parseProfiles: claude-plugins source is kept for home only", () => {
const text = JSON.stringify({
agents: [{ id: "a", match: ["a"], sources: [{ scope: "home", kind: "claude-plugins" }] }],
});
assert.deepEqual(parseProfiles(text).profiles[0].sources, [{ scope: "home", kind: "claude-plugins" }]);
});
test("DEFAULT_PROFILES: claude-code keeps the builtins and the five sources", () => {
const cc = DEFAULT_PROFILES[0];
assert.equal(cc.id, "claude-code");
assert.deepEqual(cc.match, ["claude-code", "claude"]);
assert.deepEqual(
cc.builtins.map((b) => b.key),
BUILTINS["claude-code"].map((b) => b.key),
);
assert.deepEqual(cc.sources, [
{ scope: "project", path: ".claude/commands", pattern: "*.md", prefix: "/" },
{ scope: "project", path: ".claude/skills", pattern: "*/SKILL.md", prefix: "/" },
{ scope: "home", path: ".claude/commands", pattern: "*.md", prefix: "/" },
{ scope: "home", path: ".claude/skills", pattern: "*/SKILL.md", prefix: "/" },
{ scope: "home", kind: "claude-plugins" },
]);
const codex = DEFAULT_PROFILES[1];
assert.equal(codex.id, "codex");
assert.deepEqual(codex.sources, []);
assert.equal(codex.builtins.length, 4);
});
+25 -1
View File
@@ -2,7 +2,7 @@ import test from "node:test";
import assert from "node:assert/strict"; import assert from "node:assert/strict";
import { import {
HISTORY_LIMIT, queueKey, loadHistory, saveHistory, loadQueue, saveQueue, loadUsage, saveUsage, HISTORY_LIMIT, queueKey, loadHistory, saveHistory, loadQueue, saveQueue, loadUsage, saveUsage,
KEYS, draftKey, loadDraft, saveDraft, KEYS, draftKey, loadDraft, saveDraft, loadDock, saveDock,
} from "../herdr/herdr-composer/mods/herdr-composer/storage.js"; } from "../herdr/herdr-composer/mods/herdr-composer/storage.js";
const memStore = () => { const memStore = () => {
@@ -236,3 +236,27 @@ test("migration: a store that cannot be written to still reads the old data", ()
const store = { get: (k) => raw.get(k), set: () => { throw new Error("read-only"); } }; const store = { get: (k) => raw.get(k), set: () => { throw new Error("read-only"); } };
assert.deepEqual(loadHistory(store).map((e) => e.id), ["old"]); assert.deepEqual(loadHistory(store).map((e) => e.id), ["old"]);
}); });
test("dock roundtrip under herdr-composer.dock", () => {
const store = memStore();
const d = [{ id: "1", label: "a", text: "a", mode: "send" }, { id: "2", label: "b", text: "b", mode: "insert" }];
saveDock(store, d);
assert.equal(KEYS.dock, "herdr-composer.dock");
assert.deepEqual(store.get("herdr-composer.dock"), d);
assert.deepEqual(loadDock(store), d);
});
test("dock does not read the legacy key", () => {
const store = memStore();
store.set("ovis-composer.dock", [{ id: "1", label: "a", text: "a", mode: "send" }]);
assert.deepEqual(loadDock(store), []);
assert.equal(store.get("herdr-composer.dock"), undefined);
});
test("dock rubbish loads as empty", () => {
const store = memStore();
store.set("herdr-composer.dock", "smieci");
assert.deepEqual(loadDock(store), []);
store.set("herdr-composer.dock", { a: 1 });
assert.deepEqual(loadDock(store), []);
});