Compare commits
27
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
dc5dcc9cc6 | ||
|
|
1b12550d04 | ||
|
|
0263eca263 | ||
|
|
1a78b5dcf3 | ||
|
|
89ac517cab | ||
|
|
2631d86f0e | ||
|
|
f1102524cc | ||
|
|
3f78fe912d | ||
|
|
56fa39dd18 | ||
|
|
02f7f2465b | ||
|
|
a4c7f25307 | ||
|
|
f379b9470c | ||
|
|
000df780be | ||
|
|
bb86c74995 | ||
|
|
7e23b8a79c | ||
|
|
f880f7ef06 | ||
|
|
989fa88345 | ||
|
|
fa44ec0bf7 | ||
|
|
3c65a4f577 | ||
|
|
52d2259060 | ||
|
|
3292b04989 | ||
|
|
68fa3677d1 | ||
|
|
76004542ab | ||
|
|
a404829261 | ||
|
|
3b457aad1c | ||
|
|
6b1f946d25 | ||
|
|
4bb0e85612 |
No files matched your search
@@ -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`.
|
||||||
@@ -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, options.cwd === undefined ? {} : { cwd: options.cwd });
|
||||||
result = await exec(command, args, { cwd });
|
} catch {
|
||||||
} catch {
|
continue;
|
||||||
return null;
|
}
|
||||||
|
if (!result || result.code !== 0) continue;
|
||||||
|
|
||||||
|
const found = [];
|
||||||
|
for (const line of String(result.stdout ?? "").split("\n")) {
|
||||||
|
const match = /^(\d+)\t(.+)$/.exec(line.replace(/\r$/, ""));
|
||||||
|
if (match) found.push({ index: Number(match[1]), path: slashes(match[2]).trim() });
|
||||||
|
}
|
||||||
|
return { shell: command, found };
|
||||||
}
|
}
|
||||||
if (!result || result.code !== 0) return null;
|
throw new Error(
|
||||||
|
relative ? "nie udało się wczytać katalogu projektu" : "nie udało się wczytać katalogu globalnego",
|
||||||
return String(result.stdout ?? "")
|
);
|
||||||
.split("\n")
|
|
||||||
.map((line) => {
|
|
||||||
const path = line.trim();
|
|
||||||
// PowerShell writes the separators of its own platform.
|
|
||||||
return windowsPaths ? path.replace(/\\/g, "/") : path;
|
|
||||||
})
|
|
||||||
.filter(Boolean);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -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 |
@@ -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");
|
||||||
|
});
|
||||||
@@ -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);
|
||||||
|
});
|
||||||
@@ -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
@@ -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), []);
|
||||||
|
});
|
||||||
Reference in new issue
Block a user