Nexus Dev 17726c4dc3 docs(21-06): complete chat search and Cmd+K gap closure plan

- Add 21-06-SUMMARY.md documenting search filtering and keyboard shortcut
- Advance STATE.md to ready_for_verification, 100% progress
- ROADMAP.md phase 21 marked Complete (7/7 summaries)

2026-04-04 03:55:47 +00:00

3.3 KiB

Raw Blame History

phase

plan

subsystem

tags

dependency_graph

tech_stack

key_files

decisions

metrics

21-chat-foundation

chat

keyboard-shortcuts

filtering

requires

provides

affects

HIST-02

INPUT-07

ChatConversationList

useChatConversations

chatApi

chatService

chatRoutes

useKeyboardShortcuts

Layout

added

patterns

custom-event-bus

debounced-input

ilike-filter

global-keyboard-shortcut

created

modified

server/src/services/chat.ts

server/src/routes/chat.ts

ui/src/api/chat.ts

ui/src/hooks/useChatConversations.ts

ui/src/components/ChatConversationList.tsx

ui/src/hooks/useKeyboardShortcuts.ts

ui/src/components/Layout.tsx

Used custom window event (nexus:focus-chat-search) instead of forwardRef drilling to focus search input from Cmd+K — avoids threading refs through ChatPanel

Debounce search at 300ms via useEffect+setTimeout pattern to avoid flooding the server with requests on every keystroke

Cmd+K handler placed before the input-guard early return in useKeyboardShortcuts so it fires even when typing in inputs/textareas

duration	completed	tasks	files
~10 min	2026-04-01	2	7

Phase 21 Plan 06: Chat Search and Cmd+K Shortcut Summary

Gap closure for HIST-02 (conversation search) and INPUT-07 (Cmd+K keyboard shortcut): server-side ilike filtering on conversation titles with a debounced search input, plus Cmd+K to open chat panel and focus search.

What Was Built

Task 1: Server-side search and agentId filtering

chatService.listConversations extended with search?: string and agentId?: string opts; adds ilike(chatConversations.title, '%term%') and eq(chatConversations.agentId, id) conditions when provided
GET /companies/:companyId/conversations route extracts search and agentId from req.query
chatApi.listConversations serializes search and agentId as URL query params
useChatConversations accepts opts?: { search?: string }, includes search in queryKey (triggers refetch on change), passes to API

Task 2: Search input UI and Cmd+K shortcut

ChatConversationList renders a search input with Search icon (left) and clear X button (right); 300ms debounce; passes debouncedSearch to useChatConversations
ChatConversationList listens for nexus:focus-chat-search custom window event to focus the input
useKeyboardShortcuts adds onSearch?: () => void to ShortcutHandlers; Cmd+K/Ctrl+K handler is placed BEFORE the input-guard early return (fires globally)
Layout wires onSearch to open chat panel if closed, then dispatches nexus:focus-chat-search via requestAnimationFrame

Verification Results

TypeScript: no new chat-related errors in server or UI (pre-existing plugin-sdk errors in plugins.ts are out of scope)
All tests pass: chat-service (21), chat-routes (11), ChatMarkdownMessage (4), ChatInput (6) — 42 total
Search input present with placeholder "Search conversations..."
Cmd+K handler on metaKey || ctrlKey + k in useKeyboardShortcuts
Route passes search/agentId params

Deviations from Plan

None — plan executed exactly as written. Used the simpler custom-event approach (suggested as ALTERNATIVE in plan) rather than forwardRef/useImperativeHandle, as plan explicitly recommended this path.

Known Stubs

None.

3.3 KiB Raw Blame History