Carlos Florêncio
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
---
|
|
id: "01-core-and-task-search"
|
|
title: "Core external mention search"
|
|
status: completed
|
|
wave: 1
|
|
depends_on: []
|
|
plan: "plan.md"
|
|
spec: "../../specs/ui/requirements/entity-reference-composer.md"
|
|
---
|
|
|
|
# Task 01: Core External Mention Search
|
|
|
|
## Acceptance
|
|
|
|
- Normalized provider service validates plain queries, runs bounded providers concurrently, and returns deterministic partial groups with safe statuses.
|
|
- Registry uses provider descriptors, owns provider identity/canonical ref construction, and accepts an arbitrary namespaced fake provider without native-provider switches, proving a future plugin bridge can use the same seam.
|
|
- Registry binds a unique `(provider, kind)` reference authorizer so search destinations and later submissions use the same provider-owned scope checks.
|
|
- HTTP handler implements the spec contract without central route registration yet.
|
|
- Kandev tasks are not registered in this provider registry because existing task discovery remains owned by `@`.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
cd apps/backend && go test ./internal/mentions/...
|
|
```
|
|
|
|
## Files likely touched
|
|
|
|
- `apps/backend/pkg/api/v1/mentions.go`
|
|
- `apps/backend/internal/mentions/types.go`
|
|
- `apps/backend/internal/mentions/service.go`
|
|
- `apps/backend/internal/mentions/handler.go`
|
|
- `apps/backend/internal/mentions/service_test.go`
|
|
- `apps/backend/internal/mentions/handler_test.go`
|
|
|
|
## Dependencies
|
|
|
|
None.
|
|
|
|
## Inputs
|
|
|
|
Spec API/failure/plugin-compatibility sections; ADR provider boundary; ADR 0043 stable DTO rules and RPC direction.
|
|
|
|
## Output contract
|
|
|
|
Report contract/type choices, ranking/cap/timeout behavior, files changed, exact test result, blockers, risks, and set this task plus plan checkbox to done.
|