feat: add cross-integration entity references (#1862)
* feat: add cross-integration entity references * fix(web): anchor entity reference menu to composer * fix: keep Kandev tasks under @ mentions * fix: address entity reference review findings * test(e2e): use option role for prompt menu * test(e2e): update passthrough mention roles * fix: preserve queued references and paginate Azure PRs
This commit is contained in:
@@ -0,0 +1,50 @@
|
||||
# ADR-2026-07-21-work-item-reference-search: Backend-Normalized Work-Item References
|
||||
|
||||
**Status:** accepted
|
||||
**Date:** 2026-07-21
|
||||
**Area:** backend, frontend, protocol
|
||||
|
||||
## Context
|
||||
|
||||
Kandev's chat composer currently builds `@` suggestions in the browser from unrelated local sources. Work-item search spans seven provider families with different credentials, workspace scopes, query languages, pagination, identities, and failure modes. A selected item must also remain unambiguous after its title or repository changes and while a message waits in the durable queue.
|
||||
|
||||
## Decision
|
||||
|
||||
Kandev owns work-item typeahead behind a backend provider registry in `internal/mentions`. Every provider implements a plain-text, workspace-scoped search boundary and translates that query into its private API dialect. Registry and aggregate service depend only on hand-defined, versioned normalized DTOs plus a provider descriptor; they do not import native Jira/GitHub/etc. models, plugin wire models, `structpb`, or switch exhaustively on native provider IDs. The aggregate endpoint runs providers concurrently with bounded work and timeouts, returns deterministic provider/kind groups, and treats provider failures as partial results with safe status codes.
|
||||
|
||||
Providers return candidates with provider-local immutable identity plus non-secret connection scope. The registry injects its registered provider identity, validates candidate fields, and constructs the canonical versioned `ref`; an adapter cannot spoof another provider. Each `(provider, kind)` registration also owns a `ReferenceAuthorizer`, used both to filter search destinations and to authorize message submission against the trusted conversation workspace. This keeps configured-origin and scope checks provider-owned without a central provider switch. Jira and GitHub adapters retain upstream immutable IDs that their current projections drop; providers without a single global ID use a documented provider-native composite. URLs and titles are presentation snapshots, not identity.
|
||||
|
||||
The frontend uses a separate `#` `entityReference` atom. `@` remains the context-attachment channel for files, prompts, and plans. New task discovery moves to `#`, while legacy `@task` nodes remain compatible.
|
||||
|
||||
Selected references serialize into both portable Markdown links in visible message content and typed `entity_references` in existing message/queue metadata JSON. A neutral `internal/entityrefs` leaf owns structural normalization, canonical identity, and deduplication; provider authorization remains in `internal/mentions`. Metadata drives chip rendering and sanitized agent context; Markdown is the durable fallback. No new reference table or synchronized cross-provider index is introduced.
|
||||
|
||||
Built-in integrations register adapters through this host seam. `provider` and `kind` are validated, additive strings with generic presentation fallbacks, not closed enums. A future `PluginProviderBridge` can therefore enumerate active plugins with an explicit mention-provider contribution and adapt a typed Kandev-to-plugin `Plugin.SearchMentions` RPC to the same `MentionProvider` interface. This is not part of the plugin-to-Kandev `Host` data API and does not reuse `api_read`. Defining the manifest contribution, permission/grant, additive RPC, lifecycle/error mapping, and workspace authorization is a separate public-contract decision following [ADR 0043](0043-plugin-host-data-api.md); this feature does not add them. Older plugins that return gRPC `Unimplemented` will map to provider-unavailable without failing other sources.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Workspace isolation, provider query escaping, timeouts, error classification, and identity normalization live in one backend boundary instead of being duplicated in React.
|
||||
- Adding a built-in provider requires an adapter and conformance tests but does not change the composer contract.
|
||||
- Migrating a built-in integration to a plugin replaces its adapter registration with a plugin bridge while preserving registry-issued provider/source IDs (or explicit aliases), normalized reference identity, message metadata, and frontend behavior. New plugin-only providers use reserved namespaced IDs.
|
||||
- Jira and GitHub search models must preserve upstream immutable IDs. Azure DevOps and Sentry adapters need bounded project/repository or instance/organization discovery because their current browse APIs require extra scope.
|
||||
- Typeahead consumes external API quota. Client debounce/cancellation, server caps, and provider timeouts are correctness requirements. Any provider/client cache must be short-lived and keyed by workspace plus provider connection scope so it cannot cross authorization boundaries.
|
||||
- Partial results are expected. Cross-provider scores are not compared; results stay grouped and deterministic.
|
||||
- Message and queue metadata already provide restart durability, avoiding a migration and reference lifecycle table. Stale targets keep their display snapshot but are not guaranteed to open successfully.
|
||||
- Plugins cannot contribute `#` results until a future contribution, permission, and Kandev-to-plugin RPC contract is designed, but current core code must not add coupling that would require a second composer/search contract.
|
||||
|
||||
## Alternatives Considered
|
||||
|
||||
### Fan out from the frontend
|
||||
|
||||
Rejected. It would expose provider query dialects and failure semantics to React, duplicate workspace/config checks, complicate cancellation, and make every new provider a composer change.
|
||||
|
||||
### Reuse the existing `@` mention pipeline
|
||||
|
||||
Rejected. `@` items attach local context and have different serialization/selection semantics. Mixing external durable entities into that union would preserve the current overloaded menu and make migration harder.
|
||||
|
||||
### Store only plain text or Markdown links
|
||||
|
||||
Rejected. Mutable labels and URLs cannot reliably identify a task or work item for agent tools, queue edits, history recall, or sent-message chip rendering.
|
||||
|
||||
### Create a normalized reference table or local search index
|
||||
|
||||
Rejected for this release. References do not own target lifecycle, and synchronizing every provider would add migrations, webhook/polling consistency, retention, and stale-index behavior before typeahead needs them.
|
||||
@@ -62,3 +62,4 @@ Read individual ADRs for full context. Create new ones via `/record decision` or
|
||||
| 2026-07-20-explicit-local-repository-trust | [Explicit Local Repository Trust](2026-07-20-explicit-local-repository-trust.md) | accepted | backend, frontend | 2026-07-20 |
|
||||
| 2026-07-20-provider-neutral-remote-repositories | [Provider-neutral remote repositories](2026-07-20-provider-neutral-remote-repositories.md) | accepted | backend, frontend, protocol | 2026-07-20 |
|
||||
| 2026-07-20-repository-provider-origin-identity | [Persist Provider Origin In Repository Identity](2026-07-20-repository-provider-origin-identity.md) | accepted | backend, frontend | 2026-07-20 |
|
||||
| 2026-07-21-work-item-reference-search | [Backend-normalized work-item references](2026-07-21-work-item-reference-search.md) | accepted | backend, frontend, protocol | 2026-07-21 |
|
||||
|
||||
@@ -0,0 +1,206 @@
|
||||
---
|
||||
spec: docs/specs/ui/entity-reference-composer.md
|
||||
decision: docs/decisions/2026-07-21-work-item-reference-search.md
|
||||
created: 2026-07-21
|
||||
status: implemented
|
||||
---
|
||||
|
||||
# Implementation Plan: Entity Reference Composer
|
||||
|
||||
## Overview
|
||||
|
||||
Build a backend-normalized, workspace-scoped provider registry first, then add each external adapter without sharing mutable files. Registry and DTOs stay transport- and provider-neutral so native adapters can later be replaced by a plugin bridge with an explicit contribution and workspace permission. After central wiring and durable message metadata work, add the frontend search/client, `#` atom, composer interaction, sent-message chips, and desktop/mobile E2E.
|
||||
|
||||
## Backend
|
||||
|
||||
### Normalized search contract
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/backend/pkg/api/v1/mentions.go` (new)
|
||||
- `apps/backend/internal/mentions/types.go` (new)
|
||||
- `apps/backend/internal/mentions/service.go` (new)
|
||||
- `apps/backend/internal/mentions/handler.go` (new)
|
||||
- `apps/backend/internal/mentions/service_test.go` (new)
|
||||
- `apps/backend/internal/mentions/handler_test.go` (new)
|
||||
|
||||
Define `MentionProvider.Descriptor()` plus `MentionProvider.Search(ctx, SearchRequest)`, normalized groups/results/statuses, validation, deterministic group order, bounded concurrent all-settled execution, per-provider timeouts, safe errors, and the HTTP handler. Core registry code accepts arbitrary validated source/provider/kind IDs and uses descriptor labels/generic fallbacks; it contains no native-provider type switch. The registry owns provider identity and canonical `ref` construction, while adapters return bounded untrusted candidates with provider-local identity. Each unique `(provider, kind)` may also register a `ReferenceAuthorizer`; search filtering and later submission validation dispatch through that same provider-owned seam. Do not register Kandev tasks in this search contract: existing Kandev task discovery remains owned by `@`, while `#` is external-integration search only.
|
||||
|
||||
### External provider adapters
|
||||
|
||||
Each adapter owns plain-query translation, workspace/config checks, stable identity mapping, exact destination/scope authorization for search and submission, safe failure classification, and focused tests in separate files:
|
||||
|
||||
- Jira: preserve immutable issue ID and generate escaped text/key JQL in `internal/jira/service_mentions.go`.
|
||||
- Linear: use the existing structured `SearchFilter.Query` path.
|
||||
- GitHub: preserve REST/node IDs and generate title-only issue/PR queries through workspace-scoped search.
|
||||
- GitLab: include host + immutable object ID and add a workspace-scoped safe search wrapper.
|
||||
- Azure DevOps: generate escaped WIQL for work items and add project-level active-PR listing/title filtering without repository-by-repository browser fan-out.
|
||||
- Sentry: search every configured workspace instance through bounded organization discovery, include instance ID in scope, and escape free text.
|
||||
|
||||
Provider adapters live in `apps/backend/internal/mentions/provider_<name>.go`; provider-owned safe methods live beside their existing service/client code. No adapter registers routes or edits central backend composition.
|
||||
|
||||
### Message and queue reference metadata
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/backend/internal/orchestrator/message_meta.go`
|
||||
- `apps/backend/internal/task/handlers/message_handlers.go`
|
||||
- `apps/backend/internal/task/handlers/message_handlers_test.go`
|
||||
- `apps/backend/internal/orchestrator/handlers/queue_handlers.go`
|
||||
- `apps/backend/internal/orchestrator/handlers/queue_handlers_test.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/service.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/repository_sqlite.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/repository_sqlite_test.go`
|
||||
- `apps/backend/internal/task/models/message_shell_output.go`
|
||||
- `apps/backend/internal/task/models/message_shell_output_test.go`
|
||||
|
||||
Extract structural normalization/canonicalization into a neutral `internal/entityrefs` leaf, then validate, deduplicate, and persist `entity_references` for direct messages and queue add/update/drain. A conversation resolver derives trusted workspace from the persisted session/task; provider authorization dispatches through the registry and fails closed for unknown providers. Queue update replaces metadata instead of retaining deleted links. Project typed metadata to clients and build one sanitized agent-facing reference system block. Keep legacy `@task` context behavior intact.
|
||||
|
||||
### Composition and route wiring
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/backend/internal/backendapp/types.go`
|
||||
- `apps/backend/internal/backendapp/services.go`
|
||||
- `apps/backend/internal/backendapp/helpers.go`
|
||||
- `apps/backend/internal/backendapp/mentions.go` (new)
|
||||
- `apps/backend/internal/backendapp/mentions_test.go` (new)
|
||||
|
||||
Construct adapters from available services, register them through stable provider descriptors, validate the workspace before fan-out, and mount `GET /api/v1/workspaces/:workspaceId/mentions/search`. Built-ins have deterministic descriptor order; the registry can also accept future dynamic descriptors without native-provider switches. Nil/unconfigured services must degrade to safe statuses. Add an aggregate integration test covering mixed success, disconnect, timeout, caps, and workspace isolation.
|
||||
|
||||
### Future plugin migration seam
|
||||
|
||||
This release does not change plugin manifests, protobufs, SDKs, or runtime. It does establish constraints for that later work:
|
||||
|
||||
- normalized result/reference DTOs are hand-mapped, versioned, additive, and independent of native structs, plugin wire models, and `structpb`, matching ADR 0043's public DTO rule;
|
||||
- provider registration is dynamic and descriptor-driven, so a future plugin bridge registers providers without changing aggregation or React code; registry code injects provider identity and constructs canonical refs from validated plugin-local candidates;
|
||||
- registry-issued source/provider IDs are stable across a native-to-plugin migration (or retain explicit aliases); brand-new plugin providers use reserved namespaced IDs and generic UI fallbacks;
|
||||
- workspace scope is an explicit provider input, leaving the future bridge one place to enforce plugin workspace grants;
|
||||
- provider timeout, cancellation, partial failure, URL validation, and result caps apply equally to native and future plugin-backed providers; and
|
||||
- no task in this plan adds a `mentions.providers` manifest contribution, plugin workspace permission/grant, or `Plugin.SearchMentions` gRPC RPC. Those public wire and permission changes require their own plugin spec/ADR. Search flows Kandev-to-plugin and must not be inferred from plugin categories or reuse the plugin-to-Kandev Host data API/`api_read` capability.
|
||||
|
||||
## Frontend
|
||||
|
||||
### API client and search hook
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/web/lib/types/entity-reference.ts` (new)
|
||||
- `apps/web/lib/api/domains/mentions-api.ts` (new)
|
||||
- `apps/web/lib/api/domains/mentions-api.test.ts` (new)
|
||||
- `apps/web/hooks/use-entity-reference-search.ts` (new)
|
||||
- `apps/web/hooks/use-entity-reference-search.test.ts` (new)
|
||||
|
||||
Add normalized types/client and a 250 ms debounced, abortable/generation-guarded hook. Search only with an active workspace and non-empty query. Preserve grouped partial results and a safe retryable aggregate error state.
|
||||
|
||||
### Composer and mobile interaction
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/web/components/task/chat/entity-reference-types.ts` (new)
|
||||
- `apps/web/components/task/chat/tiptap-entity-reference-extension.tsx` (new)
|
||||
- `apps/web/components/task/chat/tiptap-entity-reference-suggestion.ts` (new)
|
||||
- `apps/web/components/task/chat/entity-reference-menu.tsx` (new)
|
||||
- `apps/web/components/task/chat/tiptap-input.tsx`
|
||||
- `apps/web/components/task/chat/use-tiptap-editor.ts`
|
||||
- `apps/web/components/task/chat/tiptap-helpers.ts`
|
||||
- `apps/web/components/task/chat/popup-menu.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-body.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-container.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-area.tsx`
|
||||
- `apps/web/components/task/passthrough-chat-composer.tsx`
|
||||
|
||||
Add a separate `entityReference` atom/plugin/menu; do not widen `MentionItem` or `ContextMention`. Explicitly enable `#` in task chat and Quick Chat and leave passthrough disabled. Keep Kandev task discovery under `@`, including legacy node parsing, and defensively omit any Kandev-task group returned to the external-only `#` menu. Serialize safe generated Markdown links, preserve draft JSON, carry reference metadata in history/reverse-search entries so only generated links rehydrate, and expose structured references from the editor handle.
|
||||
|
||||
Improve the shared popup's visual-viewport clamping, internal scroll owner, semantic listbox/option roles, pointer outside-dismiss, wrapping/truncation, and `min-h-11` touch rows.
|
||||
|
||||
### Mobile design contract
|
||||
|
||||
- **Desktop outcome / mobile entry:** typing `#` in the existing task/Quick Chat composer opens the same capability at both viewports.
|
||||
- **Nearest exemplar:** shared `PopupMenu` and mobile slash-command composer supply anchored-above-caret selection; `MobilePickerSheet` is only a fallback if visual-viewport containment cannot preserve typing continuity.
|
||||
- **Hierarchy / primary action:** provider and kind headings group a one-dimensional result list; selecting one row is the primary action.
|
||||
- **Presentation:** anchored popover above the composer. This short, frequent typeahead must keep the software keyboard and caret active; a drawer would interrupt the typing loop.
|
||||
- **Geometry:** visual viewport owns bounds, result body owns the only scroll, safe-area/keyboard clearance is explicit, rows are at least 44 px, and document horizontal overflow stays zero.
|
||||
- **Shared logic:** query state, grouping, selection, serialization, and validation are shared; only viewport geometry changes.
|
||||
- **Proof:** `mobile-entity-reference-composer.spec.ts` inserts and sends a reference by touch and asserts containment/no document overflow.
|
||||
|
||||
### Submission, queue, and sent rendering
|
||||
|
||||
Files:
|
||||
|
||||
- `apps/web/components/task/chat/chat-input-container.tsx`
|
||||
- `apps/web/components/task/chat/use-chat-input-container.ts`
|
||||
- `apps/web/components/task/chat/use-chat-input-state.ts`
|
||||
- `apps/web/components/task/chat/chat-input-area.tsx`
|
||||
- `apps/web/hooks/use-message-handler.ts`
|
||||
- `apps/web/hooks/domains/session/use-queue.ts`
|
||||
- `apps/web/lib/api/domains/queue-api.ts`
|
||||
- `apps/web/lib/types/http.ts`
|
||||
- `apps/web/lib/state/slices/session/types.ts`
|
||||
- `apps/web/components/task/chat/messages/entity-reference-chip.tsx` (new)
|
||||
- `apps/web/components/task/chat/messages/chat-message.tsx`
|
||||
- `apps/web/components/task/chat/queued-ghost-message.tsx`
|
||||
|
||||
Replace the growing positional composer callback with a named submit payload, then carry `entity_references` through direct send and queue add/update. Render metadata-matched generated links as chips; unknown/missing metadata remains normal Markdown. Queue edits recompute references from surviving generated links. Preserve passthrough and existing context attachments without enabling `#` there.
|
||||
|
||||
## Tests
|
||||
|
||||
- Aggregator unit tests: deterministic groups, validation/caps, timeout/cancellation, partial errors, and sanitized statuses in `internal/mentions/service_test.go`.
|
||||
- One focused adapter suite per provider for stable identity, workspace scope, escaping, fan-out bounds, cancellation, and error mapping.
|
||||
- Handler/composition integration tests: HTTP request through real service registry with mixed fake adapters.
|
||||
- Message/queue tests: direct persistence, queue update replacement, restart round-trip, drain, deduplication, unsafe metadata, metadata projection, and prompt-block sanitization.
|
||||
- Frontend unit tests: URL construction, debounce/stale suppression, trigger boundaries, keyboard selection, serialization/history rehydration, viewport geometry, named submit payload, queue clearing, sent chip rendering, and legacy `@task` compatibility.
|
||||
|
||||
## E2E Tests
|
||||
|
||||
- `apps/web/e2e/tests/chat/entity-reference-composer.spec.ts`: task chat Arrow/Tab insertion, no auto-send, explicit send/clickable chip, partial provider result, draft restore, Quick Chat parity, and literal passthrough `#`.
|
||||
- `apps/web/e2e/tests/chat/mobile-entity-reference-composer.spec.ts`: touch selection/send, 44 px row, keyboard/visual-viewport containment, internal scrolling, and no document horizontal overflow.
|
||||
|
||||
## Risks
|
||||
|
||||
- External typeahead can exhaust API quotas; debounce, cancellation, provider timeouts, and fan-out caps are mandatory. Any cache introduced by an adapter/client must include workspace and provider-connection scope in its key.
|
||||
- GitHub/GitLab configuration history includes install-wide auth. Adapters must enforce workspace operational scope and validate the workspace before using shared credentials.
|
||||
- Jira, Azure, GitHub/GitLab, and Sentry accept provider query languages today. Only provider-owned safe methods may translate the plain query.
|
||||
- Azure PR and Sentry searches require extra scope discovery. Provider tests must prove bounded work and cancellation rather than silently omitting connected scopes.
|
||||
- Hot frontend files already approach lint limits; new state, menus, atoms, and renderers stay extracted.
|
||||
- Native-only switches or DTOs would make planned integration-to-plugin migration breaking. Conformance tests use an arbitrary fake provider descriptor to prove aggregation and frontend grouping remain generic.
|
||||
|
||||
## Verification
|
||||
|
||||
Targeted commands are recorded in each task file. Final integrated verification runs in this order:
|
||||
|
||||
```bash
|
||||
make fmt
|
||||
make typecheck test lint
|
||||
cd apps/web && pnpm e2e:run tests/chat/entity-reference-composer.spec.ts tests/chat/mobile-entity-reference-composer.spec.ts
|
||||
```
|
||||
|
||||
## Implementation Waves
|
||||
|
||||
Wave 1:
|
||||
|
||||
- [x] [task-01-core-and-task-search](task-01-core-and-task-search.md)
|
||||
|
||||
Wave 2 (parallel after Task 01):
|
||||
|
||||
- [x] [task-02-jira-provider](task-02-jira-provider.md)
|
||||
- [x] [task-03-linear-provider](task-03-linear-provider.md)
|
||||
- [x] [task-04-github-provider](task-04-github-provider.md)
|
||||
- [x] [task-05-gitlab-provider](task-05-gitlab-provider.md)
|
||||
- [x] [task-06-azure-provider](task-06-azure-provider.md)
|
||||
- [x] [task-07-sentry-provider](task-07-sentry-provider.md)
|
||||
- [x] [task-08-message-reference-metadata](task-08-message-reference-metadata.md)
|
||||
|
||||
Wave 3:
|
||||
|
||||
- [x] [task-09-backend-composition](task-09-backend-composition.md)
|
||||
|
||||
Wave 4 (sequential):
|
||||
|
||||
- [x] [task-10-frontend-search-client](task-10-frontend-search-client.md)
|
||||
- [x] [task-11-composer-reference-ui](task-11-composer-reference-ui.md)
|
||||
- [x] [task-12-message-reference-ui](task-12-message-reference-ui.md)
|
||||
|
||||
Wave 5:
|
||||
|
||||
- [x] [task-13-e2e-and-verification](task-13-e2e-and-verification.md)
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
id: "01-core-and-task-search"
|
||||
title: "Core external mention search"
|
||||
status: completed
|
||||
wave: 1
|
||||
depends_on: []
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/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.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
id: "02-jira-provider"
|
||||
title: "Jira mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 02: Jira Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Jira ticket projections preserve immutable upstream issue ID plus key/title/URL/site scope.
|
||||
- Plain text becomes backend-generated, escaped key-or-title JQL; callers cannot inject raw JQL.
|
||||
- Adapter enforces explicit workspace config and maps auth/rate/timeout/upstream failures safely.
|
||||
- Provider authorizer accepts only the configured workspace site origin/scope for search and submission.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/jira/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/jira/models.go`
|
||||
- `apps/backend/internal/jira/cloud_client.go`
|
||||
- `apps/backend/internal/jira/cloud_client_test.go`
|
||||
- `apps/backend/internal/jira/service_mentions.go`
|
||||
- `apps/backend/internal/jira/service_mentions_test.go`
|
||||
- `apps/backend/internal/mentions/provider_jira.go`
|
||||
- `apps/backend/internal/mentions/provider_jira_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec sources/security/failure requirements; `SearchTicketsForWorkspace`; Jira response conversion tests.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report identity and escaping behavior, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
id: "03-linear-provider"
|
||||
title: "Linear mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 03: Linear Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Linear adapter searches issues with structured `SearchFilter.Query` and explicit workspace scope.
|
||||
- Results retain immutable issue ID, identifier, title, URL, and non-secret workspace/org scope.
|
||||
- Missing config and upstream failures map to normalized statuses with cancellation preserved.
|
||||
- Provider authorizer validates workspace organization scope and canonical Linear destinations.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/linear/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/linear/service_mentions.go`
|
||||
- `apps/backend/internal/linear/service_mentions_test.go`
|
||||
- `apps/backend/internal/mentions/provider_linear.go`
|
||||
- `apps/backend/internal/mentions/provider_linear_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec provider contract; existing `SearchIssuesForWorkspace`, `LinearIssue.ID`, and GraphQL query tests.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report mapping/scope, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
id: "04-github-provider"
|
||||
title: "GitHub mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 04: GitHub Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Issue and PR search projections preserve immutable REST/node identity through PAT and `gh` paths.
|
||||
- Plain text becomes backend-generated title-only GitHub search and respects workspace repository/org scope.
|
||||
- Issue and PR groups remain separate, cached/scoped safely, bounded, cancellable, and safely classified.
|
||||
- Provider authorizers validate the workspace-owned repository/organization scope and canonical GitHub host.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/github/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/github/models.go`
|
||||
- `apps/backend/internal/github/client_helpers.go`
|
||||
- `apps/backend/internal/github/pat_client.go`
|
||||
- `apps/backend/internal/github/gh_client.go`
|
||||
- `apps/backend/internal/github/service_mentions.go`
|
||||
- `apps/backend/internal/github/service_mentions_test.go`
|
||||
- `apps/backend/internal/mentions/provider_github.go`
|
||||
- `apps/backend/internal/mentions/provider_github_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
ADR identity rule; workspace settings search wrappers; existing search-cache and workspace-scope tests.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report identity propagation/query generation/cache scope, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
id: "05-gitlab-provider"
|
||||
title: "GitLab mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 05: GitLab Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Issue and MR adapters use immutable object ID plus host scope and keep human IID/project details for display.
|
||||
- Safe service methods construct title-search parameters without accepting raw GitLab filters.
|
||||
- Search validates workspace-owned config/scope and never leaks install-wide results across workspaces.
|
||||
- Provider authorizers fail closed unless the result host/project is proven to belong to the active workspace.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/gitlab/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/gitlab/service_mentions.go`
|
||||
- `apps/backend/internal/gitlab/service_mentions_test.go`
|
||||
- `apps/backend/internal/gitlab/store.go`
|
||||
- `apps/backend/internal/mentions/provider_gitlab.go`
|
||||
- `apps/backend/internal/mentions/provider_gitlab_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
ADR 0030; GitLab `SearchUserIssuesPaged`/`SearchUserMRsPaged`; existing stable `ID`, `IID`, `ProjectID`, and host models.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report workspace enforcement/query safety, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
id: "06-azure-provider"
|
||||
title: "Azure DevOps mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 06: Azure DevOps Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Work-item search generates escaped WIQL internally and returns organization-scoped immutable IDs.
|
||||
- PR search adds a project-level active-PR read path, filters titles server-side, and avoids browser or unbounded repository fan-out.
|
||||
- Adapter respects workspace config/default project plus bounded project discovery, cancellation, caps, and safe errors.
|
||||
- Provider authorizers validate organization URL/path and project scope, not only the shared host origin.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/azuredevops/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/azuredevops/client.go`
|
||||
- `apps/backend/internal/azuredevops/rest_client.go`
|
||||
- `apps/backend/internal/azuredevops/client_models.go`
|
||||
- `apps/backend/internal/azuredevops/service_mentions.go`
|
||||
- `apps/backend/internal/azuredevops/service_mentions_test.go`
|
||||
- `apps/backend/internal/azuredevops/rest_client_test.go`
|
||||
- `apps/backend/internal/mentions/provider_azure.go`
|
||||
- `apps/backend/internal/mentions/provider_azure_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec all-source contract; existing workspace credential resolver, WIQL path, project/repository listing, and PR models.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report search/fan-out bounds and identity, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
id: "07-sentry-provider"
|
||||
title: "Sentry mention provider"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 07: Sentry Mention Provider
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Adapter searches every configured active-workspace Sentry instance through bounded organization discovery.
|
||||
- Stable reference scope includes instance ID; result ID/title/URL never collide across self-hosted instances.
|
||||
- Free text is escaped from Sentry syntax and provider calls preserve cancellation/caps/safe error mapping.
|
||||
- Provider authorizer verifies workspace-owned instance ID and that the destination matches that instance origin.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/sentry/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/sentry/client.go`
|
||||
- `apps/backend/internal/sentry/rest_client.go`
|
||||
- `apps/backend/internal/sentry/service_mentions.go`
|
||||
- `apps/backend/internal/sentry/service_mentions_test.go`
|
||||
- `apps/backend/internal/sentry/rest_client_test.go`
|
||||
- `apps/backend/internal/mentions/provider_sentry.go`
|
||||
- `apps/backend/internal/mentions/provider_sentry_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01.
|
||||
|
||||
## Inputs
|
||||
|
||||
ADR 0030 multiple-instance rules; existing `ListInstances`, instance ownership checks, browse client, and `SentryIssue.ID`.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report instance/org discovery bounds, escaping, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
id: "08-message-reference-metadata"
|
||||
title: "Durable message reference metadata"
|
||||
status: completed
|
||||
wave: 2
|
||||
depends_on: ["01-core-and-task-search"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 08: Durable Message Reference Metadata
|
||||
|
||||
## Acceptance
|
||||
|
||||
- A neutral `internal/entityrefs` leaf structurally normalizes/canonicalizes arrays; `message.add` and queue add/update resolve the persisted conversation workspace and dispatch provider authorization through the mention registry before persistence.
|
||||
- Queue persistence and both normal/workflow queue-drain paths preserve normalized reference arrays without reauthorizing previously accepted references.
|
||||
- Queue update replaces references so deleted links cannot leave stale metadata; direct/queued arrays dedupe by canonical `ref`.
|
||||
- Client projection and agent prompt context expose sanitized typed references without breaking legacy task mentions.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/task/handlers/... ./internal/task/models/... ./internal/orchestrator/handlers/... ./internal/orchestrator/messagequeue/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/orchestrator/message_meta.go`
|
||||
- `apps/backend/internal/entityrefs/reference.go`
|
||||
- `apps/backend/internal/entityrefs/reference_test.go`
|
||||
- `apps/backend/internal/task/handlers/message_handlers.go`
|
||||
- `apps/backend/internal/task/handlers/message_handlers_test.go`
|
||||
- `apps/backend/internal/orchestrator/handlers/queue_handlers.go`
|
||||
- `apps/backend/internal/orchestrator/handlers/queue_handlers_test.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/service.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/repository_sqlite.go`
|
||||
- `apps/backend/internal/orchestrator/messagequeue/repository_sqlite_test.go`
|
||||
- `apps/backend/internal/task/models/message_shell_output.go`
|
||||
- `apps/backend/internal/task/models/message_shell_output_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 01 normalized API type.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec data/API/persistence/failure sections; `UserMessageMeta`, existing message metadata projection, and queue `metadata_json` patterns.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report validation/dedup/update semantics, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
id: "09-backend-composition"
|
||||
title: "Backend provider composition"
|
||||
status: completed
|
||||
wave: 3
|
||||
depends_on:
|
||||
- "02-jira-provider"
|
||||
- "03-linear-provider"
|
||||
- "04-github-provider"
|
||||
- "05-gitlab-provider"
|
||||
- "06-azure-provider"
|
||||
- "07-sentry-provider"
|
||||
- "08-message-reference-metadata"
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 09: Backend Provider Composition
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Backend registers built-in adapters through the same descriptor-driven registrar a future plugin bridge can use, without giving adapters control of registry identity, then mounts the workspace search route.
|
||||
- Request workspace is validated before any provider call; nil/disconnected providers degrade safely.
|
||||
- Handler-to-provider integration test proves mixed success/failure, deterministic caps, cancellation, and workspace isolation.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps/backend && go test ./internal/backendapp/... ./internal/mentions/...
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/backend/internal/backendapp/types.go`
|
||||
- `apps/backend/internal/backendapp/services.go`
|
||||
- `apps/backend/internal/backendapp/helpers.go`
|
||||
- `apps/backend/internal/backendapp/mentions.go`
|
||||
- `apps/backend/internal/backendapp/mentions_test.go`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Tasks 02-08.
|
||||
|
||||
## Inputs
|
||||
|
||||
All provider constructors; existing integration service construction/route registration patterns; spec API order/status/plugin-compatibility contract; ADR 0043.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report registry order and workspace validation, files changed, exact tests, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
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/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.
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
id: "11-composer-reference-ui"
|
||||
title: "Composer entity reference interaction"
|
||||
status: completed
|
||||
wave: 4
|
||||
depends_on: ["10-frontend-search-client"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 11: Composer Entity Reference Interaction
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Valid `#` triggers in task/Quick Chat open descriptor-driven grouped search, including a generic unknown-provider fallback; arrows + Enter/Tab and touch insert a non-sending atom with trailing space.
|
||||
- Passthrough stays literal; Kandev task discovery remains under `@`, while `#` defensively omits any Kandev-task group returned by the search service.
|
||||
- Draft/history and reverse-search entries round-trip generated Markdown plus metadata, without converting ordinary links; popup stays visual-viewport-contained with one scroll owner and 44 px rows.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps && pnpm --filter @kandev/web test -- components/task/chat/tiptap-helpers.test.ts components/task/chat/use-tiptap-editor.test.ts components/task/chat/tiptap-editor-history.test.ts components/task/chat/popup-menu.test.tsx components/task/chat/entity-reference-menu.test.tsx
|
||||
cd apps && pnpm --filter @kandev/web typecheck
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/web/components/task/chat/entity-reference-types.ts`
|
||||
- `apps/web/components/task/chat/tiptap-entity-reference-extension.tsx`
|
||||
- `apps/web/components/task/chat/tiptap-entity-reference-suggestion.ts`
|
||||
- `apps/web/components/task/chat/entity-reference-menu.tsx`
|
||||
- `apps/web/components/task/chat/tiptap-input.tsx`
|
||||
- `apps/web/components/task/chat/use-tiptap-editor.ts`
|
||||
- `apps/web/components/task/chat/tiptap-helpers.ts`
|
||||
- `apps/web/components/task/chat/message-history.ts`
|
||||
- `apps/web/components/task/chat/tiptap-editor-history.ts`
|
||||
- `apps/web/components/task/chat/popup-menu.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-body.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-container.tsx`
|
||||
- `apps/web/components/task/chat/chat-input-area.tsx`
|
||||
- `apps/web/components/task/passthrough-chat-composer.tsx`
|
||||
- `apps/web/components/task/chat/tiptap-helpers.test.ts`
|
||||
- `apps/web/components/task/chat/use-tiptap-editor.test.ts`
|
||||
- `apps/web/components/task/chat/tiptap-editor-history.test.ts`
|
||||
- `apps/web/components/task/chat/popup-menu.test.tsx`
|
||||
- `apps/web/components/task/chat/entity-reference-menu.test.tsx`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 10.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec interaction/state/mobile sections; existing slash suggestion/menu; Mobile UI Language; current legacy mention tests.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report trigger/gating/serialization/mobile geometry, files changed, exact tests/typecheck, rendered mobile check, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
id: "12-message-reference-ui"
|
||||
title: "Reference submission and sent rendering"
|
||||
status: completed
|
||||
wave: 4
|
||||
depends_on: ["08-message-reference-metadata", "11-composer-reference-ui"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 12: Reference Submission and Sent Rendering
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Named composer submit payload carries references through direct send and queue add/update without stale metadata.
|
||||
- Sent and queued generated links render as clickable chips only when matched by typed metadata; ordinary Markdown stays unchanged.
|
||||
- Existing files/prompts/plan/task mentions, passthrough submission, attachments, comments, and queue behavior retain parity.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
cd apps && pnpm --filter @kandev/web test -- hooks/use-message-handler.test.ts components/task/chat/use-chat-input-state.test.ts lib/api/domains/queue-api.test.ts components/task/chat/messages/chat-message.test.tsx components/task/chat/queued-ghost-message.test.tsx components/task/passthrough-chat-composer.test.ts
|
||||
cd apps && pnpm --filter @kandev/web typecheck
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/web/components/task/chat/chat-input-container.tsx`
|
||||
- `apps/web/components/task/chat/use-chat-input-container.ts`
|
||||
- `apps/web/components/task/chat/use-chat-input-state.ts`
|
||||
- `apps/web/components/task/chat/chat-input-area.tsx`
|
||||
- `apps/web/hooks/use-message-handler.ts`
|
||||
- `apps/web/hooks/domains/session/use-queue.ts`
|
||||
- `apps/web/lib/api/domains/queue-api.ts`
|
||||
- `apps/web/lib/types/http.ts`
|
||||
- `apps/web/lib/state/slices/session/types.ts`
|
||||
- `apps/web/components/task/chat/messages/entity-reference-chip.tsx`
|
||||
- `apps/web/components/task/chat/messages/chat-message.tsx`
|
||||
- `apps/web/components/task/chat/queued-ghost-message.tsx`
|
||||
- `apps/web/components/task/passthrough-chat-composer.tsx`
|
||||
- `apps/web/hooks/use-message-handler.test.ts`
|
||||
- `apps/web/components/task/chat/use-chat-input-state.test.ts`
|
||||
- `apps/web/lib/api/domains/queue-api.test.ts`
|
||||
- `apps/web/components/task/chat/messages/chat-message.test.tsx`
|
||||
- `apps/web/components/task/chat/queued-ghost-message.test.tsx`
|
||||
- `apps/web/components/task/passthrough-chat-composer.test.ts`
|
||||
|
||||
## Dependencies
|
||||
|
||||
Tasks 08 and 11.
|
||||
|
||||
## Inputs
|
||||
|
||||
Spec persistence/scenarios; backend metadata contract; existing prompt mention rendering and queue metadata shapes.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report payload migration/render matching/queue edit semantics, files changed, exact tests/typecheck, blockers, risks, and mark task/plan done.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
id: "13-e2e-and-verification"
|
||||
title: "Entity reference E2E and integrated verification"
|
||||
status: completed
|
||||
wave: 5
|
||||
depends_on: ["12-message-reference-ui"]
|
||||
plan: "plan.md"
|
||||
spec: "../../specs/ui/entity-reference-composer.md"
|
||||
---
|
||||
|
||||
# Task 13: Entity Reference E2E and Integrated Verification
|
||||
|
||||
## Acceptance
|
||||
|
||||
- Desktop E2E proves task chat keyboard insertion/no auto-send/explicit send, clickable persistence, partial provider results, draft restore, Quick Chat parity, and literal passthrough behavior.
|
||||
- Mobile E2E proves touch selection and send, visual-viewport containment, internal scrolling, 44 px rows, and no document horizontal overflow.
|
||||
- Format, typecheck, unit/integration tests, lint, focused E2E, QA, security review, and code review complete with no unresolved required issue.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
make fmt
|
||||
make typecheck test lint
|
||||
cd apps/web && pnpm e2e:run tests/chat/entity-reference-composer.spec.ts tests/chat/mobile-entity-reference-composer.spec.ts
|
||||
```
|
||||
|
||||
## Files likely touched
|
||||
|
||||
- `apps/web/e2e/tests/chat/entity-reference-composer.spec.ts`
|
||||
- `apps/web/e2e/tests/chat/mobile-entity-reference-composer.spec.ts`
|
||||
- `apps/web/e2e/pages/session-page.ts` only for a small reusable helper
|
||||
- provider mock controllers/fixtures only where deterministic mixed-source seeding is missing
|
||||
|
||||
## Dependencies
|
||||
|
||||
Task 12 and all integrated backend work.
|
||||
|
||||
## Inputs
|
||||
|
||||
Every spec scenario; slash composer desktop/mobile precedents; E2E backend rebuild requirements.
|
||||
|
||||
## Output contract
|
||||
|
||||
Report exact commands/results, browser artifacts for failures, desktop/mobile visual findings, QA/security/review findings and fixes, files changed, blockers, residual risks, and mark task/plan done.
|
||||
@@ -17,6 +17,14 @@ In Task Chat or Quick Chat, select text from a settled agent prose reply, then s
|
||||
|
||||
Inline comments are available only on ordinary settled prose. Streaming replies, tool/thinking/status output, plans, rich-block content, raw views, and user messages do not accept inline comments.
|
||||
|
||||
### Reference tasks and work items
|
||||
|
||||
In Task Chat or an ordinary structured Quick Chat, type `#` at the start of a line or after whitespace, then enter part of a title or key. Kandev searches the active workspace's tasks and connected Jira, Linear, GitHub, GitLab, Azure DevOps, and Sentry sources. Results stay grouped by provider and type; a disconnected or slow provider does not hide results from another source.
|
||||
|
||||
Use the arrow keys and **Tab** or **Enter**, or select a row with pointer or touch. Selection inserts a chip without sending. The chip survives draft reloads and becomes a clickable reference after explicit send; messages queued while an agent is busy keep the same reference metadata. CLI-passthrough chat leaves `#` as literal text and does not search.
|
||||
|
||||
Use `@` for files, saved prompts, and the current plan. New task lookup is under `#`; existing saved or sent `@task` references remain readable and sendable.
|
||||
|
||||
Select **Quick Chat** beside **New Task** in the expanded sidebar, or select its standalone row in the collapsed sidebar.
|
||||
|
||||
### Start a chat
|
||||
|
||||
@@ -51,6 +51,7 @@ Released builds can lag this page. Check **Settings > System > About** or `kande
|
||||
| GitHub pull-request review, checks, merge, and CI-fix automation | Dependency-bound | Requires GitHub credentials and repository permissions. CI automation is opt-in. Azure has a create-PR path only; other Git hosts do not get the full task PR panel. |
|
||||
| Share a session snapshot as a secret GitHub Gist | Dependency-bound | Requires GitHub auth and a structured session outside `CREATED`/`STARTING`. The viewing URL is rendered through `gist.githack.com`; unlisted URLs and heuristic redaction are not access control or exhaustive secret detection. Payloads are capped and shares can be revoked. |
|
||||
| Quick Chat | Dependency-bound | Requires an agent profile. Repository-backed chats use isolated Kandev worktrees; closing deletes the ephemeral task permanently. Chats older than seven days are swept at startup and every 24 hours unless their session is `RUNNING` or `IDLE`. |
|
||||
| Task and work-item references in chat | Dependency-bound | Structured Task Chat and Quick Chat search workspace tasks plus connected Jira, Linear, GitHub, GitLab, Azure DevOps, and Sentry sources with `#`. Passthrough chat remains literal, and provider scope, credentials, availability, and rate limits determine external results. |
|
||||
| Utility agents and custom one-shot helpers | Dependency-bound | Require an ACP inference-capable agent and usable model. Passthrough-only agents do not satisfy this path. |
|
||||
| Configuration Chat | Limited | Each workspace currently presents one repository-less configuration conversation. Settings shows it in a tabless floating panel and can move the same session into Quick Chat. Confirmed tab closure deletes its backing task; config-mode tasks are excluded from Quick Chat expiry. |
|
||||
| Voice input | Dependency-bound | Browser Web Speech, a browser-downloaded Whisper model, and server Whisper paths exist. Selection does not retry another engine after a recognition error. Server Whisper requires `KANDEV_VOICE_OPENAI_API_KEY` (empty by default); without it the transcription route returns 503. |
|
||||
|
||||
@@ -205,9 +205,15 @@ If `intent` is omitted, the backend infers it from those fields. That inference
|
||||
|
||||
A successful response contains `success`, `task_id`, `state`, and usually `session_id`; it can also contain `agent_execution_id`, `worktree_path`, and `worktree_branch`. Session states use uppercase values such as `CREATED`, `STARTING`, `RUNNING`, `WAITING_FOR_INPUT`, `COMPLETED`, `FAILED`, and `CANCELLED`.
|
||||
|
||||
### Search work-item references over HTTP
|
||||
|
||||
The structured chat composer's `#` search calls `GET /api/v1/workspaces/:workspaceId/mentions/search?q=<plain-text>&limit=<per-source-limit>&exclude_task_id=<optional-task-id>`. `q` is required after trimming and accepts 1–200 Unicode characters. `limit` defaults to 5 and is clamped to 1–10. When supplied, `exclude_task_id` must belong to the requested workspace.
|
||||
|
||||
A successful response returns the normalized query and an ordered `groups` array. Each group includes `source`, `provider`, `kind`, `display_name`, `kind_label`, `status`, and `results`. One source can report `not_configured`, `unauthorized`, `rate_limited`, `timeout`, `upstream_error`, or `unsupported_scope` while the request remains HTTP 200 and other groups remain usable. Each result is a versioned `EntityReference` with the fields described below; raw provider errors and credentials are not returned.
|
||||
|
||||
### Send a user turn
|
||||
|
||||
`message.add` requires `task_id`, `session_id`, and either non-whitespace `content` or at least one attachment. Optional fields are `author_id`, `model`, `plan_mode`, `has_review_comments`, `attachments`, and `context_files`.
|
||||
`message.add` requires `task_id`, `session_id`, and either non-whitespace `content` or at least one attachment. Optional fields are `author_id`, `model`, `plan_mode`, `has_review_comments`, `attachments`, `context_files`, and `entity_references`.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -222,6 +228,10 @@ A successful response contains `success`, `task_id`, `state`, and usually `sessi
|
||||
}
|
||||
```
|
||||
|
||||
`entity_references` is the structured companion to work-item Markdown links inserted by the `#` composer. Each version-1 entry carries `ref`, `provider`, `kind`, immutable `id`, optional display `key`, title snapshot, canonical `url`, and provider-connection `scope`. The backend derives the workspace from the persisted session, validates canonical identity and destination through the registered provider, deduplicates by `ref`, and rejects the request when a supplied reference is invalid or unauthorized. CLI-passthrough sessions do not accept structured references.
|
||||
|
||||
`message.queue.add` accepts the same optional array. `message.queue.update` also accepts it and treats the array as a replacement: send `[]` after removing every generated reference link so stale metadata is cleared. Queue status and message responses return validated entries under `metadata.entity_references`.
|
||||
|
||||
If the agent is busy, use the `message.queue.*` operations rather than retrying `message.add`. Permission prompts are represented in persisted/session message data; answer one with `permission.respond`. Its payload requires `session_id` and `pending_id`, plus `option_id` unless `cancelled:true`; optional `rejected:true` distinguishes an explicit denial from dismissing the prompt.
|
||||
|
||||
For a raw diagnostic session, install a WebSocket client such as `websocat`, connect, then paste one request object per line:
|
||||
|
||||
@@ -117,6 +117,7 @@ Subscription quota tracking and per-agent cheap-model profile routing.
|
||||
| [review-file-status](ui/review-file-status.md) | building |
|
||||
| [sidebar-view-creation](ui/sidebar-view-creation.md) | shipped |
|
||||
| [slash-command-composer](ui/slash-command-composer.md) | shipped |
|
||||
| [entity-reference-composer](ui/entity-reference-composer.md) | draft |
|
||||
| [settings-manual-save](ui/settings-manual-save.md) | shipped |
|
||||
| [mobile-task-navigation](ui/mobile-task-navigation.md) | shipped |
|
||||
| [task-layout-profiles](ui/task-layout-profiles.md) | draft |
|
||||
|
||||
@@ -0,0 +1,174 @@
|
||||
---
|
||||
status: shipped
|
||||
created: 2026-07-21
|
||||
owner: kandev
|
||||
---
|
||||
|
||||
# Entity Reference Composer
|
||||
|
||||
## Why
|
||||
|
||||
Users discuss external work items in agent chat, but plain ticket keys and pull-request numbers are ambiguous and easy to mistype. They need one fast way to search the active workspace's connected systems and insert a durable reference that both people and agents can resolve. Kandev tasks already have the established `@` mention path.
|
||||
|
||||
## What
|
||||
|
||||
- Task chat and Quick Chat support a `#` entity-reference trigger in their shared TipTap composer. Passthrough, task creation, comments, plans, Office text inputs, and other editors remain unchanged.
|
||||
- Typing `#` at the start of a text block or after whitespace opens a search menu directly above the composer. Its rendered bottom edge stays anchored to the composer even when only a short result set is visible. A `#` inside another token or a code block remains literal text.
|
||||
- After the user types at least one query character, search covers the active workspace's connected, searchable sources:
|
||||
- Jira tickets;
|
||||
- Linear issues;
|
||||
- GitHub issues and pull requests;
|
||||
- GitLab issues and merge requests;
|
||||
- Azure DevOps work items and pull requests; and
|
||||
- Sentry issues.
|
||||
- Results respect the provider configuration and scope owned by the active workspace. Kandev tasks are excluded even if a stale or misbehaving search response contains a `kandev_tasks` group.
|
||||
- Results are grouped by provider and work-item kind. Provider order and ordering within each group are deterministic; Kandev does not present unrelated provider scores as globally comparable relevance. Sources that are not configured or cannot search the active workspace are omitted from the menu rather than rendered as empty unavailable sections.
|
||||
- Search groups carry provider-neutral display descriptors. Composer, message, and queue code use normalized fields and a generic fallback rather than exhaustive switches over native integrations, so a future plugin bridge can supply the same contract.
|
||||
- Search is debounced, cancels or ignores stale requests, and caps work per provider and configured workspace/project scope. Each connected provider continues examining available in-scope results until it finds the requested number of matches, has no more results, reaches a search bound, or the request is canceled. One disconnected, slow, rate-limited, or failing provider never hides successful results from other providers.
|
||||
- Arrow Up and Arrow Down move the active result. Tab or Enter selects it. Pointer or touch selection has the same behavior. Escape closes the menu without changing or sending the draft.
|
||||
- Selection replaces only the active `#query` range with an inline reference chip, appends a trailing space, keeps focus in the composer, and never submits or queues the message.
|
||||
- A chip displays a stable key when one exists (for example `#ENG-123` or `#123`) and otherwise a concise title. It retains a title snapshot and source label for disambiguation.
|
||||
- Submitted references remain clickable in sent user messages through a canonical HTTP(S) URL whose origin matches the workspace's validated provider configuration.
|
||||
- Visible message content serializes each chip to a portable Markdown link. Structured reference metadata is persisted with direct and queued user messages so rendering and agent context never depend on parsing a mutable title.
|
||||
- Draft storage preserves the structured chip. Recalling a sent message rehydrates links produced by this feature into chips; ordinary Markdown links remain ordinary links.
|
||||
- If a referenced item is later renamed, deleted, disconnected, or inaccessible, the sent message keeps its label snapshot and Markdown fallback. Opening the target may then show the destination's normal unavailable behavior.
|
||||
- `@` remains the context-attachment trigger for Kandev tasks, files, saved prompts, and the current plan. `#` is reserved for external work items.
|
||||
- Provider titles, URLs, keys, and error text are untrusted. Kandev validates reference shapes and destinations, escapes provider query languages server-side, and sanitizes agent-facing context.
|
||||
- Each registered `(provider, kind)` owns its destination/scope authorizer. The same provider-owned rule filters search hits and authorizes direct or queued submission against the workspace derived from the persisted conversation; unknown or ambiguous providers fail closed.
|
||||
|
||||
## Data model
|
||||
|
||||
`EntityReference` is a versioned value stored in `messages.metadata.entity_references` and, while queued, `queued_messages.metadata_json.entity_references`. No new table is introduced.
|
||||
|
||||
| Field | Type | Contract |
|
||||
| ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `version` | integer | `1` for this contract. Unknown versions render through visible Markdown only. |
|
||||
| `ref` | string | Canonical opaque identity, unique within one provider connection and kind. |
|
||||
| `provider` | namespaced string | Stable registry-owned provider identity. Built-ins use `jira`, `linear`, `github`, `gitlab`, `azure_devops`, or `sentry`. A built-in migrated to a plugin keeps its existing ID (or an explicit compatibility alias); a brand-new plugin contribution uses the reserved `plugin:<plugin-id>:<provider>` namespace. |
|
||||
| `kind` | string | Additive work-item kind. Built-ins use `issue`, `pull_request`, `merge_request`, or `work_item`; unknown future values use generic presentation. |
|
||||
| `id` | string | Provider-native immutable ID, or documented provider-native composite identity where no single immutable ID exists. |
|
||||
| `key` | string, optional | Human-facing identifier such as `ENG-123` or `123`. |
|
||||
| `title` | string | Sanitized display snapshot captured at selection time. |
|
||||
| `url` | string | Validated canonical provider URL. |
|
||||
| `scope` | string | Non-secret provider connection/site/instance scope needed to prevent identity collisions. |
|
||||
|
||||
Metadata is deduplicated by `ref` in first-appearance order. It never contains credentials, provider query syntax, or raw upstream error bodies.
|
||||
|
||||
The registry, not an adapter, assigns `provider` and constructs `ref` from validated provider registration, connection scope, kind, and immutable resource identity. Native and future plugin candidates are untrusted input: Kandev bounds counts and field lengths and validates UTF-8, kind, identity, and URL before exposing or persisting a result.
|
||||
|
||||
The editor's `entityReference` atom stores the same presentation and identity fields in local draft JSON. Visible serialization is `[#<key-or-title>](<url>)` with Markdown-safe text and URL encoding.
|
||||
|
||||
## API surface
|
||||
|
||||
### Search
|
||||
|
||||
`GET /api/v1/workspaces/:workspaceId/mentions/search?q=<plain text>&limit=<per-source limit>`
|
||||
|
||||
- `workspaceId` is required and must identify the active task or Quick Chat workspace.
|
||||
- `q` is plain user text, 1-200 Unicode characters after trimming. Provider query languages are not accepted.
|
||||
- `limit` defaults to 5 and is clamped to 1-10 per source.
|
||||
- A successful aggregate request returns HTTP 200 even when individual sources fail:
|
||||
|
||||
```json
|
||||
{
|
||||
"query": "auth",
|
||||
"groups": [
|
||||
{
|
||||
"source": "linear_issues",
|
||||
"provider": "linear",
|
||||
"kind": "issue",
|
||||
"display_name": "Linear",
|
||||
"kind_label": "Issue",
|
||||
"status": "ok",
|
||||
"results": [
|
||||
{
|
||||
"version": 1,
|
||||
"ref": "mention:v1:linear:issue:acme:issue-uuid",
|
||||
"provider": "linear",
|
||||
"kind": "issue",
|
||||
"id": "issue-uuid",
|
||||
"key": "ENG-123",
|
||||
"title": "Fix authentication",
|
||||
"url": "https://linear.app/acme/issue/ENG-123",
|
||||
"scope": "acme"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
- Group status is one of `ok`, `not_configured`, `unauthorized`, `rate_limited`, `timeout`, `upstream_error`, or `unsupported_scope`.
|
||||
- `source` is an opaque stable source ID. `display_name` and `kind_label` let the UI render a provider without importing its native model; unknown providers use a generic work-item icon.
|
||||
- Sources with `not_configured` or `unsupported_scope` status are omitted from the menu, but their safe status remains available in the response. Transient failures from configured sources may be shown non-disruptively. Raw provider errors are never returned.
|
||||
- Invalid query/limit returns 400. An unknown workspace returns 404. Aggregate infrastructure failure returns 500.
|
||||
|
||||
### Message submission
|
||||
|
||||
The existing `message.add`, `message.queue.add`, and `message.queue.update` payloads accept optional `entity_references: EntityReference[]`. For `message.queue.update`, omitting `entity_references` preserves existing reference metadata, an explicit empty array clears it, and a non-empty array replaces it after validation. Deleting a link from edited queue text cannot leave stale reference metadata behind when the update supplies the replacement array.
|
||||
|
||||
Message responses and queue entries expose the validated array through `metadata.entity_references`. Queue drain copies it to the created user message unchanged apart from canonical validation and deduplication.
|
||||
|
||||
## State machine
|
||||
|
||||
1. **Closed** — no active valid `#` trigger.
|
||||
2. **Primed** — the menu is open for bare `#` and prompts the user to type; no external search runs.
|
||||
3. **Searching** — a debounced request for the current query is in flight.
|
||||
4. **Results** — one or more provider groups contain selectable results; partial provider failures may also be shown non-disruptively.
|
||||
5. **Empty** — all successful providers returned no hits and no request is in flight.
|
||||
|
||||
Typing updates Primed/Searching/Results/Empty. Escape, moving outside the trigger range, selection, session change, or composer unmount returns to Closed. A response whose query generation is no longer current has no state transition.
|
||||
|
||||
## Permissions
|
||||
|
||||
- Search is workspace-scoped. A provider adapter may use only credentials, instances, repository scope, projects, and operational settings associated with `workspaceId`, following [ADR 0030](../../decisions/0030-workspace-scoped-integration-settings.md).
|
||||
- The backend validates that the target task or Quick Chat session belongs to the same workspace as submitted provider scopes.
|
||||
- Search results and message metadata expose no credentials or secret identifiers.
|
||||
- Opening a reference uses the destination's existing authorization behavior; selection does not grant new provider access.
|
||||
|
||||
## Failure modes
|
||||
|
||||
- A provider timeout, auth failure, rate limit, malformed upstream response, or unsupported workspace scope produces a safe group status while other groups remain selectable.
|
||||
- If the aggregate endpoint is unreachable, the menu preserves the draft and shows a retryable error state. It never submits the draft.
|
||||
- Stale responses after continued typing, session changes, or menu dismissal are ignored.
|
||||
- Invalid or unsafe returned URLs are discarded. URLs must use HTTP(S) and match the configured provider origin; internal routes are rejected.
|
||||
- Provider query text is escaped inside provider adapters. User text never becomes raw JQL, WIQL, GitHub/GitLab qualifiers, or Sentry query syntax.
|
||||
- Malformed submitted reference metadata is rejected or omitted from structured metadata without executing or resolving its URL. The visible Markdown text remains ordinary user content.
|
||||
|
||||
## Persistence guarantees
|
||||
|
||||
- Composer drafts preserve entity-reference atoms through the existing per-session local draft JSON.
|
||||
- Direct messages and queued messages preserve normalized reference metadata in their existing JSON metadata columns across backend restarts.
|
||||
- Sent visible content preserves a portable Markdown-link fallback even if metadata is missing or a future client does not understand its version.
|
||||
- Search results, in-flight requests, provider health snapshots, and typeahead caches are transient and need not survive restart.
|
||||
|
||||
## Scenarios
|
||||
|
||||
- **GIVEN** task chat in workspace A with connected Jira and GitHub providers, **WHEN** the user types `#auth`, **THEN** the menu above the composer shows grouped workspace-A Jira and GitHub hits without Kandev tasks or workspace-B results.
|
||||
- **GIVEN** a search returns only one short result group, **WHEN** the menu renders, **THEN** its bottom edge remains directly anchored to the composer instead of reserving unused menu height.
|
||||
- **GIVEN** GitLab is not configured or cannot search the active workspace, **WHEN** another source returns results, **THEN** the menu omits GitLab rather than showing an unavailable GitLab section.
|
||||
- **GIVEN** Quick Chat and a matching Linear issue, **WHEN** the user presses Arrow Down and Tab, **THEN** the active range becomes one inline reference chip, focus stays in the composer, and no message is sent.
|
||||
- **GIVEN** the menu is open on a phone viewport, **WHEN** the user taps a result, **THEN** the same chip is inserted and every required row is touch reachable without horizontal document overflow.
|
||||
- **GIVEN** GitHub times out while Jira returns hits, **WHEN** search finishes, **THEN** Jira results remain selectable and GitHub exposes only a safe timeout state.
|
||||
- **GIVEN** the user types another character before an earlier request returns, **WHEN** the older response arrives last, **THEN** only results for the newest query are displayed.
|
||||
- **GIVEN** a connected provider's first available results do not match the query but later in-scope results do, **WHEN** the user searches, **THEN** matching results are returned up to the requested per-source limit unless the provider has no more results, a workspace/project search bound is reached, or the request is canceled.
|
||||
- **GIVEN** a selected external reference followed by ordinary text, **WHEN** the user explicitly sends, **THEN** the visible message contains a clickable chip/Markdown fallback and its stable identity is stored in message metadata and supplied to the agent as sanitized reference context.
|
||||
- **GIVEN** the agent is busy, **WHEN** the user queues a message containing two references, **THEN** both references survive queue display, backend restart, drain, and sent-message rendering.
|
||||
- **GIVEN** the user edits a queued message and removes one generated reference link, **WHEN** the edit is saved, **THEN** metadata no longer contains the removed reference.
|
||||
- **GIVEN** a queued message already has reference metadata, **WHEN** an update omits `entity_references`, **THEN** the existing metadata is preserved.
|
||||
- **GIVEN** a queued message already has reference metadata, **WHEN** an update supplies an empty `entity_references` array, **THEN** the existing metadata is cleared.
|
||||
- **GIVEN** a queued message already has reference metadata, **WHEN** an update supplies a valid non-empty `entity_references` array, **THEN** the validated array replaces the existing metadata.
|
||||
- **GIVEN** a sent reference, **WHEN** the user recalls the message into an empty composer, **THEN** generated reference Markdown becomes an editable reference chip with the same identity.
|
||||
- **GIVEN** task chat with a sibling Kandev task, **WHEN** the user types `@` and searches its title, **THEN** the existing task suggestion remains available and sends through the established task-context behavior.
|
||||
- **GIVEN** passthrough mode, task creation, or a comment textarea, **WHEN** the user types `#auth`, **THEN** the text remains literal and no entity-reference search opens.
|
||||
- **GIVEN** a provider title containing newlines, angle brackets, or a fake system tag, **WHEN** the reference is sent, **THEN** agent context remains within one sanitized Kandev system block.
|
||||
|
||||
## Out of scope
|
||||
|
||||
- Kandev tasks, people, agents, files, prompts, plans, branches, commits, or arbitrary web-page references under `#`.
|
||||
- Slack message search; Slack has no issue-like reference contract in this release.
|
||||
- Task creation, comments, plan editing, Office text inputs, passthrough, and terminal inputs.
|
||||
- Creating, importing, transitioning, closing, or otherwise mutating a selected work item.
|
||||
- Raw provider query-language syntax, advanced filters, user-controlled result pagination, or a full-screen global search page.
|
||||
- Implementing the plugin manifest contribution, workspace permission/grant, Kandev-to-plugin search RPC, or loading plugin-provided sources in this release. The normalized registry and DTO MUST remain transport-neutral so a later plugin bridge can implement the same provider contract without changing composer/message formats. Search-provider contribution is distinct from the plugin-to-Kandev Host data API and its `api_read` capabilities.
|
||||
- Cross-workspace search.
|
||||
Reference in New Issue
Block a user