docs: design and plan for the send confirmation
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
dc5dcc9cc6
commit
0fad0a2e4e
2 files changed
+43
No files matched your search
@@ -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) <[email protected]>`.
|
||||
Reference in new issue
Block a user