Carlos Florêncio
72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
---
|
|
id: "02-listing-pull-and-create"
|
|
title: "Listing pull refresh and mobile create"
|
|
status: done
|
|
wave: 2
|
|
depends_on: ["01-foreground-recovery"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/ui/requirements/task-surface-refresh.md"
|
|
---
|
|
|
|
# Task 02: Listing pull refresh and mobile create
|
|
|
|
## Acceptance
|
|
|
|
- Kanban/Home and List use authoritative guarded callbacks for foreground and
|
|
manual refresh while retaining rendered data on failure.
|
|
- Mobile List and Kanban refresh only after an eligible downward pull from the
|
|
active vertical scroll owner's top; horizontal, multi-touch, mid-scroll, and
|
|
below-threshold gestures do not refresh.
|
|
- Mobile List renders the shipped safe-area-aware FAB, opens the existing
|
|
create dialog in current context, and refreshes the current List after a
|
|
matching task is created.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
cd apps && pnpm --filter @kandev/web test -- --run hooks/domains/kanban/use-all-workflow-snapshots.test.ts hooks/domains/kanban/use-all-workflow-snapshots-inflight.test.ts lib/mobile/pull-to-refresh.test.ts
|
|
```
|
|
|
|
## Files likely touched
|
|
|
|
- `apps/web/hooks/domains/kanban/use-all-workflow-snapshots.ts`
|
|
- `apps/web/hooks/domains/kanban/use-all-workflow-snapshots.test.ts`
|
|
- `apps/web/hooks/domains/kanban/use-all-workflow-snapshots-inflight.test.ts`
|
|
- `apps/web/lib/mobile/pull-to-refresh.ts`
|
|
- `apps/web/lib/mobile/pull-to-refresh.test.ts`
|
|
- `apps/web/components/mobile/pull-to-refresh.tsx`
|
|
- `apps/web/components/kanban-board.tsx`
|
|
- `apps/web/components/kanban/mobile-fab.tsx`
|
|
- `apps/web/app/tasks/tasks-page-client.tsx`
|
|
- `apps/web/app/tasks/tasks-list-view.tsx`
|
|
|
|
## Dependencies
|
|
|
|
Task 01.
|
|
|
|
## Parallelism
|
|
|
|
Sequential. Kanban and List share the new refresh and pull contracts.
|
|
|
|
## Inputs
|
|
|
|
- Spec: mobile create, pull, Kanban/List foreground behavior, race/failure
|
|
requirements.
|
|
- Mobile design contract in `plan.md`.
|
|
- Existing request-generation guards in List and multi-workflow snapshot
|
|
fetches.
|
|
- Existing Kanban FAB and `TaskCreateDialog`.
|
|
|
|
## Risks
|
|
|
|
- Gesture arbitration with Embla and task DnD.
|
|
- Active `kanban` and `kanbanMulti` state diverging after a forced refresh.
|
|
- Explicit/manual error feedback accidentally appearing for silent foreground
|
|
refresh.
|
|
|
|
## Output contract
|
|
|
|
Report RED failures, changed files, exact verification result, rendered mobile
|
|
check status, residual risks, and update this task plus `plan.md` status in the
|
|
primary conversation.
|