docs: composer dock design, mockup and plan
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
7fc7d0202c
commit
4bb0e85612
3 files changed
+487
No files matched your search
@@ -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,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,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.
|
||||
Reference in new issue
Block a user