homelab-codex-ws/services/kb-query/README.md

# kb-query

FastAPI search API in front of the module-5 KB retrieval engine (`packages/kb-retrieval/`).

Dokumentacja: [kb/services/kb-query.md](../../kb/services/kb-query.md)
fix(kb): README-wskazniki dla services i hosts + wyjatek ken-legacy Naprawa kontraktu CLAUDE.md §Service Structure (opcja b). Migracja do KB zabrala README z katalogow serwisow i hostow, przez co 0/26 katalogow services/ spelnialo wymagany layout. Wskazniki przywracaja nawigacje, nie duplikujac tresci. 31 wskaznikow, jednolity format, dokladnie 5 linii: # <nazwa> <jedno zdanie opisu> Dokumentacja: [kb/...](../../kb/...) Opis nie jest pisany od zera — wyciagany z kb-doca: pierwsze pelne zdanie pierwszego akapitu (sklejane z zawinietych linii, ciete tylko tam, gdzie backticki i nawiasy sa zbilansowane), a dla node'ow czlon tytulu H1 po myslniku. Dla ha-mcp opis z H1, bo pierwszy akapit zaczyna sie od markera statusu. Wiodace markery "Status: ..." sa zdejmowane. 26 x services/<svc>/README.md, 5 x hosts/<node>/README.md. WYJATEK services/home-assistant/config/ken-legacy/README.md: pelne ostrzezenie "historical archive, do not deploy" przywrocone doslownie z historii (odzyskane z drzewa sprzed migracji) + link do kb-doca. Ostrzezenie musi stac tam, gdzie chroni — w katalogu archiwum, nie tylko w KB. Odwolanie do services/home-assistant/DESIGN.md przepiete na kb/decisions/ha-configs-as-code.md + kb/incidents/2026-07-22-ha-dwie-instancje.md. check_okf.py: POINTER_GLOBS + is_pointer() wykluczaja wskazniki ze scope'u lintu. Wskazniki celowo NIE maja frontmattera OKF — to nawigacja, nie dokumenty KB. Wykluczenie zapisane wprost, zeby poszerzenie SCOPE nie zaczelo ich nagle walidowac. Bez wskaznikow: hosts/chelsty-ha/ i hosts/lustro/ — nie maja dokumentow w kb/nodes/ (luka odnotowana juz w reconie etapu 1). Utworzenie ich wymagaloby napisania nowej dokumentacji, czyli wyjscia poza konwersje. Lint: 190/190 ZGODNE. Weryfikacja 822 plikow: 0 martwych linkow. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> 2026-08-04 16:25:26 +02:00			`# kb-query`

			FastAPI search API in front of the module-5 KB retrieval engine (`packages/kb-retrieval/`).

			`Dokumentacja: [kb/services/kb-query.md](../../kb/services/kb-query.md)`