homelab-codex-ws/docs
oskar 17640526ef feat(mail-body-ingest): circuit breaker na martwy backend embed przed Etapem B
Tolerancja pojedynczego nieudanego batcha jest słuszna, przeżycie martwej Ollamy
już nie. Parse archiwum jest jednowątkowy i wyprzedza GPU, więc przy Etapie B
(~212k kopert bez --since) padnięta Ollama przemieliłaby resztę korpusu z
prędkością parse'u, oznaczając każdy chunk jako chunks_errors — bez ani jednego
zapisu, ale kosztem ~2 h przebiegu do powtórzenia. Znany tryb awarii
Ollama@SOLARIA jest totalny (zniknięcie kontenera / network-detach, 4 incydenty,
§1.4/§7), nie częściowy, więc próg z kolejnych porażek trafia w niego od razu.

--max-embed-failures N (domyślnie 5, 0 wyłącza) → EmbedBackendUnavailableError
i exit 2, odrębny od exit 1 (który pełny korpus osiąga legalnie na pojedynczych
parse_errors — §1.5). Licznik zeruje się po udanym batchu, więc kryterium jest
"kolejnych", nie "łącznie". Przy abortcie dopychane są zaległe wpisy
entities[type=threading]: nie zależą od Ollamy, są idempotentne, a ich odtworzenie
oznaczałoby ponowny odczyt tych samych 27 GB. Nowy licznik embed_batch_failures
jest wyłącznie diagnostyczny — równania bilansu bez zmian.

Plan §9: dopisane decyzje operatora do Etapu B (plastry po 50k, breaker, pominięty
dry-run całości, hybrid default poza zakresem) + nota jak czytać exit 1 vs exit 2.

Testy: 4 nowe (trip po N kolejnych, reset po sukcesie, 0 wyłącza, flush threadingu
przy abortcie); 55 passed mail-body-ingest, 25 passed kb-retrieval. Smoke:
--limit 5 dry-run na żywym kb-postgres@PIHA — bilans domknięty, zero zapisów,
zero wywołań Ollamy.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 16:53:04 +02:00
..
architecture merge: solaria gid-fix docs + recon appendix 2026-08-03 16:48:42 +02:00
incidents docs(incidents): root-cause zniknięcia ollama@SOLARIA — node-agent prune bez filtrów co 60 s 2026-07-30 20:19:06 +02:00
infra docs(infra): audyt niezarzadzanych stackow VPS — mapa przed konsolidacja do GitOps 2026-07-27 17:49:37 +02:00
kb feat(mail-body-ingest): circuit breaker na martwy backend embed przed Etapem B 2026-08-04 16:53:04 +02:00
sessions docs: session log 2026-07-31 — KB faza 4 zamknieta + pilot narty27 2026-08-04 14:39:52 +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 mitigation(solaria): M1 — NODE_TYPE=lte_node wyłącza prune node-agenta 2026-08-04 14:49:22 +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