From 0fad0a2e4e4fd2184627f0c95a11a2b315f41281 Mon Sep 17 00:00:00 2001 From: Factor Date: Fri, 20 Nov 2026 10:05:15 +0100 Subject: [PATCH] docs: design and plan for the send confirmation Co-Authored-By: Claude Opus 5.5 --- .../plans/2026-11-20-send-confirmation.md | 29 +++++++++++++++++++ .../2026-11-20-send-confirmation-design.md | 14 +++++++++ 2 files changed, 43 insertions(+) create mode 100644 docs/superpowers/plans/2026-11-20-send-confirmation.md create mode 100644 docs/superpowers/specs/2026-11-20-send-confirmation-design.md diff --git a/docs/superpowers/plans/2026-11-20-send-confirmation.md b/docs/superpowers/plans/2026-11-20-send-confirmation.md new file mode 100644 index 0000000..3ed6f4c --- /dev/null +++ b/docs/superpowers/plans/2026-11-20-send-confirmation.md @@ -0,0 +1,29 @@ +# Potwierdzenie wysyłki — plan implementacji + +**Spec:** `docs/superpowers/specs/2026-11-20-send-confirmation-design.md` (czytaj całość). +**Gałąź:** `feature/send-confirmation`. Bez push. + +## Ograniczenia globalne +- Czasy dosłownie: `SENT_MS = 1500`, `NOTICE_MS = 3000` (stałe eksportowane z `view.js` lub `state.js`, gdzie pasuje). +- Timery tylko przez `cx.timer.after` (jak `draftTimer`); poprzedni timer anulowany (`.cancel()`) przed nowym. +- Logika testowalna w czystej funkcji; GPUI tylko w `main.js`. + +## Review Focus +1. Komunikat `info` A, po 2 s komunikat `problem` B: timer A nie może skasować B. Test w Task 1. +2. Dwie wysyłki w odstępie 1 s: ✓ widoczne do 1,5 s po drugiej (timer odnowiony). +3. Wysyłka nieudana (błąd `hc`): bez ✓, czerwony komunikat jak dziś. +4. Wysyłka do kolejki (agent pracuje): komunikat o kolejce znika po 3 s, ✓ się nie pokazuje (nic nie poszło do terminala). + +### Task 1: czysta logika (test) +**Produkuje** w `view.js`: `export function noticeExpired(current, scheduled): boolean` — `true`, gdy `current` to ten sam obiekt co `scheduled` i `scheduled.level === "info"`. +- [ ] Testy w `tests/view.test.mjs` (RED): ten sam obiekt `info` → `true`; inny obiekt o tym samym tekście → `false`; `problem`/`error` → `false`; `current === null` → `false`. +- [ ] Implementacja, `npm test` PASS. + +### Task 2: `main.js` +- `notice(text, level, cx)`: zapamiętaj obiekt komunikatu; dla `"info"` ustaw (anulując poprzedni) `this.noticeTimer = cx.timer.after(NOTICE_MS, (cx) => { if (noticeExpired(this.state.notice, scheduled)) { this.state = reduce(this.state, { type: "notice", notice: null }); cx.notify(); } })`. Gdy `cx` brak (wywołania bez `cx`) — użyj `cx` dostępnego w miejscu wywołania: przejrzyj wszystkie `this.notice(` i dopisz `cx`, gdzie jest w zasięgu; gdzie go nie ma, komunikat zniknie przy najbliższym `notice`/akcji (zapisz listę takich miejsc w raporcie). +- 4 × `this.notice("Wysłano do terminala.")` → `this.flashSent(cx)`: `this.sentUntil = Date.now() + SENT_MS`, timer `SENT_MS` → `cx.notify()` (odnowiony przy kolejnym wywołaniu); dodatkowo wyczyść bieżący komunikat `info` (stara informacja nie wisi). +- Render: gdzie dziś wybierany jest `renderStop` / `renderSend`, najpierw: `Date.now() < this.sentUntil` → `renderSent(t)` (kółko 32 px, `rounded(999)`, `bg(t.done)`, „✓”, `text_size(13)`, `font_semibold()`, bez `on_click`). +- Komentarz na górze `main.js` (linia ~23) i `delivery.js:16` o „Wysłano do terminala” zaktualizuj. +- [ ] `npm test` PASS, `node --check main.js` OK. +- [ ] README: jeśli wspomina „Wysłano do terminala”, popraw. +- [ ] Commit (oba taski razem albo osobno): `feat: a green check confirms a send and info notices fade after 3 s` + `Co-Authored-By: Ovis Fast (Claude) `. diff --git a/docs/superpowers/specs/2026-11-20-send-confirmation-design.md b/docs/superpowers/specs/2026-11-20-send-confirmation-design.md new file mode 100644 index 0000000..549c490 --- /dev/null +++ b/docs/superpowers/specs/2026-11-20-send-confirmation-design.md @@ -0,0 +1,14 @@ +# Potwierdzenie wysyłki bez komunikatu — projekt (krótki) + +Data: 2026-11-20 · Mod: `herdr/herdr-composer/mods/herdr-composer/` + +## Cel i powód +Komunikat „Wysłano do terminala.” pod kartą composera zabiera miejsce w pionie terminalowi i wisi, aż zastąpi go inny. Potwierdzenie ma być tam, gdzie patrzy użytkownik (przycisk wysyłki), a komunikaty informacyjne mają nie zajmować miejsca na stałe. + +## Zakres +- **✓ zamiast „Wysłano do terminala.”** Po udanej wysyłce (4 miejsca w `main.js`, dziś `this.notice("Wysłano do terminala.")`) przez **1,5 s** w miejscu przycisku wysyłki/Stop jest zielone kółko 32 px (`t.done`) z „✓” (kolor `t.solid_foreground` albo `t.background` — byle czytelny). Kliknięcie nic nie robi. Potem wraca `↵` albo Stop, zgodnie z bieżącym stanem. Druga wysyłka w trakcie odnawia 1,5 s. Komunikat „Wysłano do terminala.” znika całkowicie (nie jest ustawiany). +- **Komunikaty `info` znikają po 3 s.** Każdy komunikat poziomu `"info"` jest czyszczony po **3 s** — chyba że w tym czasie pojawił się inny komunikat (timer czyści tylko ten, który ustawił). `"problem"` i `"error"` zostają jak dziś (do zastąpienia). +- Bez zmian: toasty błędów, kolejka, chip statusu, Esc. + +## Podejścia +Znikający komunikat / usunięcie komunikatu / ✓ na przycisku. **Wybrane: ✓ na przycisku** (decyzja użytkownika) plus znikanie pozostałych `info` po 3 s (decyzja użytkownika). Mój wybór: ✓ ma pierwszeństwo przed Stop przez 1,5 s (inaczej byłby niewidoczny, bo po wysyłce agent od razu „pracuje”); Stop w tym czasie zastępuje `Esc`.