oskar/kb-wiki
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
9 commits 1 branch 0 tags 94 KiB
Python 100%
Find a file
oskar a540a99a1b lint: raport rekoncyliacji Etap 1 — 74/74 sources + 150/150 przypisów inline zweryfikowane w bazie 
Rekoncyliacja faza 5 etap 1 (kb-m5-faza5-wiki.md §4), krok 3 z 3 — lint na
całości po scaleniu. Zakres: wszystkie 7 stron-konceptów tego repo (5
lipcowych + 2 przeniesione z sesji 08-27; `fll-2025-26` już scalone w
commicie c4127b9, przed tą serią).

check_okf.py: ZGODNE, 74/74 par (envelope_id, chunk_id) z bloków `sources:`
zweryfikowanych w KB_DSN (SELECT-only). Osobny, pełny przebieg (skrypt
jednorazowy, nieskomitowany) po wszystkich przypisach inline
`[^envelope_id#chunk_id]` w treści (nie tylko agregacie `sources:`,
`check_okf.py` nie parsuje Markdown): 150/150 zweryfikowanych, 0
zdegradowanych do fallback envelope-only. Zero wiszących linków `[[...]]`,
zero błędów przypisania chunk→envelope.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W7AnxL6pbgySpEgcCwAfww
2026-08-27 19:56:05 +02:00
_meta lint: raport rekoncyliacji Etap 1 — 74/74 sources + 150/150 przypisów inline zweryfikowane w bazie 2026-08-27 19:56:05 +02:00
osoby compile: przenieś podmioty/mbank i osoby/pawel-cesar-sanjuan-szklarz z sesji Etapu 1 2026-08-27 19:55:35 +02:00
podmioty compile: przenieś podmioty/mbank i osoby/pawel-cesar-sanjuan-szklarz z sesji Etapu 1 2026-08-27 19:55:35 +02:00
sprawy compile: scal fll-2025-26 — dwie niezależne kompilacje (2026-07-21 paperless-only, 2026-08-27 +gmail) 2026-08-27 19:39:06 +02:00
tematy struktura: katalogi, konwencje, README 2026-07-21 15:42:02 +02:00
umowy struktura: katalogi, konwencje, README 2026-07-21 15:42:02 +02:00
.gitignore struktura: katalogi, konwencje, README 2026-07-21 15:42:02 +02:00
check_okf.py tool: przenieś check_okf.py walidator OKF z sesji Etapu 1 2026-08-27 19:55:45 +02:00
INDEX.md compile: przenieś podmioty/mbank i osoby/pawel-cesar-sanjuan-szklarz z sesji Etapu 1 2026-08-27 19:55:35 +02:00
README.md struktura: katalogi, konwencje, README 2026-07-21 15:42:02 +02:00

README.md

kb-wiki

Warstwa pamięci domowej bazy wiedzy (moduł 5, faza 3 — homelab-codex-ws, docs/kb/modules/05-faza3-plan.md §8). Wzorzec: Karpathy llm-wiki (gist karpathy/442a6bf555914893e9891c11519de94f).

Czym to jest

Dwuwarstwowa architektura KB:

  • Warstwa dowodowa (kb-postgres@PIHA, poza tym repo): RAG/pgvector na chunkach dokumentów — skala docelowa 225k+ kopert, zawsze lokalna, zawsze źródło prawdy.
  • Warstwa pamięci (to repo): strony-encje w Markdownie (firma, umowa, sprawa, temat), kompilowane z wyników retrievalu, nie z surowców — destylat, nie kopia.

⚠️ Treść jest kompilowana przez LLM

Każda strona w tym repo została napisana przez model językowy (Claude) na podstawie wyników zapytań do kaskady retrievalu (streszczenia + chunki z kb-postgres), nie przez człowieka czytającego oryginalne dokumenty. Fakty liczbowe i identyfikujące mają przypisy [^envelope_id#chunk_id] wskazujące źródłowy chunk — weryfikuj przypis przy każdej decyzji, która się na tej stronie opiera (finansowej, prawnej, ubezpieczeniowej). Sprzeczne źródła są flagowane jawnie w tekście, nie ukrywane, ale kompilacja może mimo to pominąć niuans, którego model nie uznał za istotny.

Jak działa kompilacja

  1. Zapytanie po polsku trafia do kaskady retrievalu (documents_ingest.retrieval, pakiet z homelab-codex-ws/jobs/documents-ingest): embed (bge-m3, Ollama) → top-N document_summary (model claude-haiku-4-5) → top-k document_chunk w obrębie tych kopert, zawsze WHERE excluded_reason IS NULL.
  2. Sesja CC/API dostaje zwrócone chunki + streszczenia, pisze/aktualizuje stronę Markdown: fakty wyłącznie ze źródeł, przypis inline przy każdym fakcie liczbowym/identyfikującym, blok sources we frontmatterze agregujący wszystkie użyte koperty.
  3. Commit do master z opisem compile: <strona> ← <envelope_ids> — historia commitów tego repo jest audytowalną historią kompilacji (inwariant 6 szkicu operatora), stąd commitowanie bezpośrednio na master, bez task branchy (inny reżim niż homelab-codex-ws, patrz uzasadnienie niżej).

Format stron, konwencje linkowania i zasady lintu: _meta/conventions.md.

Dlaczego osobne repo, nie katalog w homelab-codex-ws

Decyzja D7 planu fazy 3: inna klasa wrażliwości (ten wiki jest destylatem danych osobistych — zdrowie, finanse, umowy — homelab-codex-ws to kod infry) i inny cykl commitów (kompilator commituje często i maszynowo; w repo infry zaśmiecałoby to historię i gryzłoby się z dyscypliną worktree tamtego repo). Git history tutaj = darmowy audit trail kompilacji, czystszy gdy w historii są wyłącznie strony wiki.

Status

Proof-of-concept fazy 3: struktura + _meta/conventions.md + 3–5 stron-encji skompilowanych ręcznie sesją CC z wyników retrievalu. Pełna kompilacja korpusu (225k+ kopert, przyrostowo) i integracja stron wiki z retrievalem jako trzeci poziom kaskady — poza zakresem tej fazy, patrz plan §8.2 i §9.