homelab-codex-ws/docs/sessions/2026-07-31-kb-f4-final-narty27.md

Session log 2026-07-31 — KB Faza 4: zamknięcie + pilot narty27

Zakres

Finalne domknięcie fazy 4 subsystemu B (KB) — na twardo — oraz podsumowanie pilota fazy 5 (narty27), wykonanego równolegle.

Faza 4 — zamknięcie (na twardo)

Dedup podwójnej implementacji fallbacku embed

• Rozstrzygnięcie: master (e7625cd, app/embed_router.py) = źródło prawdy.
• Z porzuconego brancha uratowano S1–S4 (cb8a19d):
  • retrieval_eval.py --transport http
  • session log 27.07
  • testy luk T1–T3
  • komentarz kalibracji progów dist.
• Pełny rozbiór obu implementacji: docs/kb/modules/05-fallback-dedup-raport.md.

Deploy na PIHA (z mastera)

• ollama-piha: named volume ollama_piha_models, model bge-m3, KEEP_ALIVE=0.
• kb-query: port 8230, bind 192.168.31.5, EMBED_FALLBACK_URL ustawione.

Test sol-down — PASS na żywej produkcji

Przebieg: pause ollama@SOLARIA → cache 30 s trzyma up → zapytanie przełącza się one-shot na PIHA (embed_backend: piha, wyniki poprawne) → sol_status: down → unpause → powrót up w ≤35 s.

Dodatkowo zaobserwowano samoistne, jednorazowe zadziałanie breakera na produkcji — przyczyna nieustalona, zachowanie zgodne z projektem (przełączenie i powrót bez utraty odpowiedzi).

Progi dist (skalibrowane, obowiązują)

<0.45 hit / 0.45–0.55 szara strefa / >0.55 brak odpowiedzi.

Pilot fazy 5 — narty27 (POC, zostaje na stałe)

Publiczna wystawka narty27.kapala.org zbudowana pełnym wzorcem docelowym fazy 5 w miniaturze:

markdown+frontmatter (OKF v0.1) → walidator konformancji (check_okf) → generatory (graf cytoscape, karty HTML, tabela porównawcza, zdjęcia z filtrem percepcyjnym, landing) → statyczny hosting (PIHA nginx + named volume) → publiczny ingress (NPM VPS + Let's Encrypt).

Źródło treści: ~/narty-2027/saalbach-kb — lokalny git na SOLARII, celowo poza repo infry. Infra: services/narty27.

Wnioski do przeniesienia na fazę 5 (wiki-kompilat)

1. OKF v0.1 działa w praktyce, a pinowanie wersji okazało się słuszne — spec ewoluuje (v0.2: timestamp → generated: {by, at}, provenance first-class; migracja = jedna zamiana pola). Przy fazie 5 rozważyć start od razu na v0.2 albo pin v0.1 z zaplanowaną migracją.
2. Walidator-lint jako stały element pipeline'u wiki, nie jednorazowy skrypt.
3. Bug upstreamu knowledge-catalog: generator grafu pomija linki od / wbrew §5.1 własnej spec → napisany własny generator. Kandydat na issue/PR do GoogleCloudPlatform/knowledge-catalog.
4. Reserved files: index.md bez frontmattera (poza okf_version w root) — walidator to łapie.
5. Warstwa prezentacji z generatorów — tani, użyteczny wzorzec do reużycia nad wiki-kompilatem KB.
6. Każdy artefakt ma mieć dom w gicie; sesje mają logi.

Otwarte po sesji

1. expected_envelope w mail_queries (jobs/documents-ingest/eval/queries.yaml) — nadal null (placeholdery, artefakt danych, nie kodu); kryterium 4 bramki na stubie nie przechodzi wyłącznie z tego powodu.
2. hosts/solaria/runtime/ollama/docker-compose.override.yml — brak w repo (rozjazd repo↔runtime na SOLARII).
3. R1–R3 node-agent (incydent docs/incidents/2026-07-30-ollama-solaria-vanish.md) — niezrobione: R1 _prune_stopped_containers nie może kasować kontenerów zarządzanych, R2 rate-limit dla ai_node/standard, R3 logowanie usuniętych zasobów. Przyczyna nadal aktywna → blokuje/warunkuje fazę mailową (M1 = mitygacja doraźna na czas backfillu).

Następne kroki

1. Faza mailowa: batching Ollamy → backfill ~225k kopert → IMAP przyrostówka → PDF-y (~336) → GDrive Takeout.
2. Blokada/ryzyko: node-agent R1–R3 (unfiltered prune) — eskalacja do subsystemu A; mitygacja M1 na SOLARII na czas backfillu.