Files
herdrMario/docs/superpowers/plans/2026-11-20-send-confirmation.md
2026-11-20 10:05:15 +01:00

2.8 KiB
Raw Permalink Blame History

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) <[email protected]>.