2.8 KiB
2.8 KiB
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 zview.jslubstate.js, gdzie pasuje). - Timery tylko przez
cx.timer.after(jakdraftTimer); poprzedni timer anulowany (.cancel()) przed nowym. - Logika testowalna w czystej funkcji; GPUI tylko w
main.js.
Review Focus
- Komunikat
infoA, po 2 s komunikatproblemB: timer A nie może skasować B. Test w Task 1. - Dwie wysyłki w odstępie 1 s: ✓ widoczne do 1,5 s po drugiej (timer odnowiony).
- Wysyłka nieudana (błąd
hc): bez ✓, czerwony komunikat jak dziś. - 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 obiektinfo→true; inny obiekt o tym samym tekście →false;problem/error→false;current === null→false. - Implementacja,
npm testPASS.
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(); } }). Gdycxbrak (wywołania bezcx) — użyjcxdostępnego w miejscu wywołania: przejrzyj wszystkiethis.notice(i dopiszcx, gdzie jest w zasięgu; gdzie go nie ma, komunikat zniknie przy najbliższymnotice/akcji (zapisz listę takich miejsc w raporcie).- 4 ×
this.notice("Wysłano do terminala.")→this.flashSent(cx):this.sentUntil = Date.now() + SENT_MS, timerSENT_MS→cx.notify()(odnowiony przy kolejnym wywołaniu); dodatkowo wyczyść bieżący komunikatinfo(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(), bezon_click). - Komentarz na górze
main.js(linia ~23) idelivery.js:16o „Wysłano do terminala” zaktualizuj. npm testPASS,node --check main.jsOK.- 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) <[email protected]>.