oskar/kb-wiki
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
7 commits 1 branch 0 tags 94 KiB
Python 100%
Find a file
oskar 9a383f0a8b tool: przenieś check_okf.py walidator OKF z sesji Etapu 1 
Rekoncyliacja faza 5 etap 1, krok pośredni (przed lintem). Lipcowy
proof-of-concept nie zostawił żadnego skomitowanego walidatora — weryfikacja
ad hoc, nieskomitowana (`_meta/conventions.md` §10 przed tą zmianą, dawniej
"Integracja z retrievalem" sąsiadowała bez narzędzia). Ta sesja
(~/kb-wiki-etap1-sesja-2026-08-27/) zbudowała go od zera; recon
kb-m5-faza5-wiki.md §3 rekomendował wprost: "Przenieść check_okf.py tej
sesji do prawdziwego repo przy rekoncyliacji".

Adaptacja do rzeczywistego layoutu tego repo (którego sesyjny bootstrap nie
miał w zestawie testowym):
- TYPES rozszerzone o `meta` (ten repo miało 6. typ od lipca —
  `_meta/conventions.md` już typ `meta` na sobie samym; sesyjny walidator
  znał tylko 5).
- `README.md` (root) i `INDEX.md` (root, nawigacja — `index.md` OKF-owy nie
  istnieje w tym repo, decyzja do operatora, patrz kb-m5-faza5-wiki.md §3) i
  `_meta/lint-reports/*.md` wyjęte z wymogu frontmattera stron-konceptów —
  to dokumentacja/raporty z 2026-07-21, nie skompilowane encje.

python3 check_okf.py → ZGODNE, 74/74 sources zweryfikowane w bazie (patrz
commit lintu osobno dla raportu pełnego, w tym przypisów inline).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W7AnxL6pbgySpEgcCwAfww
2026-08-27 19:55:45 +02:00
_meta docs: formalizuj sekcję "Brak danych w KB" jako konwencję (osobną od "Niepewne/sprzeczne") 2026-08-27 19:36:54 +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.