homelab-codex-ws/docs
oskar eb6e375570 feat(kb): faza 3 krok 3 — kaskada retrieval summary→chunk, bramka PASS
documents_ingest.retrieval: flat_query (baseline) i cascade_query (stage1
document_summary model='claude-haiku-4-5' -> stage2 document_chunk), jedno
dzielone wywołanie embeddingu bge-m3 per zapytanie, tylko +1 SQL na kaskadę.
Czyste query_text -> wyniki(dist, source) pod przyszłe kb-query fazy 4.
166/166 testów (10 nowych, mocki: stage1->stage2, koperta bez chunków,
N > liczba kopert, no-summaries short-circuit).

Eval-set utrwalony 1:1 z pilota (docs/kb/eval/retrieval-pilot-2026-07-16.md,
nietknięty) w eval/queries.yaml + skrypt bramki eval/retrieval_eval.py
(integracyjny, read-only, poza pytest).

Wynik bramki (żywa baza, N=10 k=5): kryterium 1 (brak degradacji) PASS,
kryterium 2 (hit@3 kaskada=5/5 vs płaski=5/5) PASS, kryterium 3 (kontrole
negatywne 0.644/0.553 > 0.55 w obu torach) PASS. Sweep N∈{1,2,3,5,10,20}:
N=5 to zmierzony próg bezpieczny (N<5 degraduje zapytania 3-4), N=10 ma
2x margines — potwierdza domyślną wartość z planu zamiast przyjmować ją
z założenia. Kaskada nie poprawia jakości na 186-dok. korpusie (dystanse
identyczne z płaskim przy N≥5) — zgodnie z przewidywaniem planu: to test
architektury pod skalę mailową, nie optymalizacja pilota.

Decyzja: kaskada (N=10, k=5, claude-haiku-4-5) = domyślna ścieżka retrievalu.
Plan-doc §6.3 zaktualizowany wynikiem; §2 D3 zamknięte rozstrzygnięciem
Oskara (tor kompilacyjny=claude-haiku-4-5, gemma3:12b w odwodzie, decyzja
mailowa odłożona do reconu z flagą prywatności/kosztu).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-17 13:56:01 +02:00
..
infra docs(ollama): GPU benchmark 207ms/embed vs 790ms CPU (~3.8x sequential) — RTX 4070 Ti SUPER, batching pozostaje dźwignią 2026-07-16 15:02:07 +02:00
kb feat(kb): faza 3 krok 3 — kaskada retrieval summary→chunk, bramka PASS 2026-07-17 13:56:01 +02:00
sessions docs(sesja): 2026-07-16 cd.2 — KB faza 3 krok 2 w toku (migracja 004, pilot streszczeń dwutorowy, bug num_ctx naprawiony) 2026-07-16 22:11:50 +02:00
access.md Document current homelab state 2026-04-15 17:37:25 +02:00
agents.md docs: uzupelnij dokumentacje pod katem agentow AI 2026-05-20 12:06:23 +02:00
backlog.md docs(sesja): 2026-07-16 control-plane — dopisanie 4 fixow (recon lustro, deploy-node --build, supervisor freeze, event flood) + aktualizacja backlogu 2026-07-16 21:30:01 +02:00
capabilities.md docs: uzupelnij dokumentacje pod katem agentow AI 2026-05-20 12:06:23 +02:00
chelsty-runtime.md docs: session summary 2026-05-27 + update observer/control-plane/chelsty docs 2026-05-27 16:18:31 +02:00
chelsty-stability-agent.md docs(chelsty): update docs and topology for site/node split 2026-05-20 14:23:57 +02:00
core-stack.md Document current homelab state 2026-04-15 17:37:25 +02:00
deployment.md docs(deployment): add critical warning — deploy.sh vps destroys control-plane (project-name divergence, 2026-06-25 incident) 2026-06-25 16:30:53 +02:00
event-system.md Implement filesystem-first runtime event system 2026-05-12 13:38:25 +02:00
hardware.md Document current homelab state 2026-04-15 17:37:25 +02:00
hetzner-vps.md Document VPS connectivity diagnostics 2026-04-15 20:38:09 +02:00
joplin-server.md Document VPS connectivity diagnostics 2026-04-15 20:38:09 +02:00
lifecycle.md Harden deployment runtime framework 2026-05-11 21:20:13 +02:00
networking.md Document current homelab state 2026-04-15 17:37:25 +02:00
node-onboarding.md Implement reproducible node onboarding 2026-05-12 13:18:00 +02:00
observer-runtime.md feat(observer): 3-state node liveness (fresh/stale/dead) + transitions + read-time net 2026-06-17 20:07:25 +02:00
questions.md Document Hetzner VPS handoff 2026-04-15 17:46:42 +02:00
service-model.md Add node capability model 2026-05-11 20:46:50 +02:00
services.md Document Hetzner VPS handoff 2026-04-15 17:46:42 +02:00
stability-agent-rollout.md Fix stability agent fleet deploy scripts 2026-05-17 21:09:06 +02:00
standards.md docs: uzupelnij dokumentacje pod katem agentow AI 2026-05-20 12:06:23 +02:00
topology.md Add CHELSTY home automation inventory model 2026-05-11 20:54:54 +02:00
vps-control-plane.md docs: session summary 2026-05-27 + update observer/control-plane/chelsty docs 2026-05-27 16:18:31 +02:00