Files
kandev/docs/plans/entity-reference-composer/task-10-frontend-search-client.md
T
2026-08-24 11:09:03 +00:00

44 lines
1.3 KiB
Markdown

---
id: "10-frontend-search-client"
title: "Frontend reference search client"
status: completed
wave: 4
depends_on: ["09-backend-composition"]
plan: "plan.md"
spec: "../../specs/ui/requirements/entity-reference-composer.md"
---
# Task 10: Frontend Reference Search Client
## Acceptance
- Typed API client encodes workspace/query/limit/current-task exclusion and preserves normalized provider groups/statuses without closed native-provider unions.
- Hook debounces non-empty queries, aborts or generation-guards stale work, and resets cleanly on workspace/session changes.
- Partial groups remain usable while aggregate failures expose a retryable state without mutating the draft.
## Verification
```bash
cd apps && pnpm --filter @kandev/web test -- lib/api/domains/mentions-api.test.ts hooks/use-entity-reference-search.test.ts
```
## Files likely touched
- `apps/web/lib/types/entity-reference.ts`
- `apps/web/lib/api/domains/mentions-api.ts`
- `apps/web/lib/api/domains/mentions-api.test.ts`
- `apps/web/hooks/use-entity-reference-search.ts`
- `apps/web/hooks/use-entity-reference-search.test.ts`
## Dependencies
Task 09 endpoint contract.
## Inputs
Spec API/state/failure sections; command-panel abort/debounce search pattern.
## Output contract
Report request lifecycle and types, files changed, exact tests, blockers, risks, and mark task/plan done.