kandev/docs/plans/task-surface-refresh/task-02-listing-pull-and-create.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
02-listing-pull-and-create	Listing pull refresh and mobile create	done	2	01-foreground-recovery	plan.md	../../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

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.