Fixes F1-F5 from the 2.0.0 script review: - removeprefix/removesuffix (3.9+) replaced; lint, retrieve and consolidate crashed on Python 3.8 with any graph edges - routines.py --mark wrote `last_run:DATE` (invalid YAML) and swallowed trailing comments into the value - export_okf.py --out must be inside outputs/ (it is rmtree'd); export_starlight.py image copies confined to wiki/assets/ - script counts in AGENTS.md, READMEs and manuals New tests/unit/ (stdlib unittest, run from smoke.sh): 3.8 API guard, routines round-trips, exporter containment, AGENTS.md consistency. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
52 KiB
Historia zmian i referencja schematu
Przeczytaj to w: English | Polski
Ten plik śledzi dwie rzeczy: schemat strony dokładnie w takiej postaci, w jakiej obowiązuje dziś, oraz to, jak projekt doszedł do swoich obecnych numerów wersji.
Istnieją dwa niezależne numery wersji i nie są tym samym:
| Numer | Mieszka w | Opisuje | Kto go podnosi |
|---|---|---|---|
kb_schema_version |
frontmatter wiki/index.md |
kontrakt treści — co strona może zawierać i co te pola znaczą | ckb-upgrade (przy potwierdzonej migracji), ckb-module (addytywnie, przy instalacji) |
| Wersja szablonu | VERSION |
warstwa narzędziowa — AGENTS.md, skille, skrypty, dokumentacja |
ckb-upgrade, gdy pobiera nowszy szablon |
Poruszają się niezależnie i jest to celowe. Możesz wziąć nowszy zestaw skilli bez dotykania choćby jednej strony wiki, a wiki napisane pod starszy schemat nadal działa — po to właśnie jest wersja schematu.
Polityka wersjonowania. Podnoś wersję pomniejszą przy zmianie addytywnej: nowe pole opcjonalne, nowa opcjonalna sekcja treści, nowy opcjonalny plik szkieletu. Podnoś wersję główną przy zmianie łamiącej kompatybilność: zmiana lub usunięcie pola wymaganego albo zmiana istniejącej zastrzeżonej konwencji nazw plików. Nigdy nie było podniesienia wersji głównej — każda dotychczasowa wersja schematu była addytywna, więc dowolna strona napisana od 2026-07-13 jest dziś nadal poprawna.
Wersja szablonu stosuje tę samą regułę do narzędzi: wersja główna, gdy
znika coś, na czym KB może polegać. Pierwsza taka, 2.0.0, usunęła obsługę
PowerShella. Poprzednia wersja główna dostaje poprawki na gałęzi
utrzymaniowej nazwanej od niej (1.x), a ckb-upgrade nigdy nie
przechodzi przez wersję główną bez pytania.
Spis treści
- Aktualny schemat strony (1.7)
- Historia wersji schematu KB
- Historia wersji szablonu
- Migracja między wersjami
Aktualny schemat strony (kb_schema_version: "1.7")
Frontmatter — każda strona niezastrzeżona
Każdy plik .md w wiki/ poza zastrzeżonymi (index.md, log.md) niesie
frontmatter YAML. Wymagane jest wyłącznie type; reszta jest opcjonalna i
preferowana tam, gdzie ma sens. Parser jest celowo prosty — wyłącznie płaskie
pary klucz: wartość, bez zagnieżdżeń.
| Pole | Wymagane | Znaczenie |
|---|---|---|
type |
tak | Otwarty ciąg: person, project, concept, library, decision, playbook, repository, component, … Nowe wartości są zawsze poprawne; czytelnicy tolerują nierozpoznane. |
resource |
nie | Kanoniczny URI autorytatywnego źródła zewnętrznego, które opisuje ta strona, trzymany oddzielnie od własnego komentarza wiki. |
tldr |
nie | Jednozdaniowe streszczenie zoptymalizowane pod odczyt przez LLM. To ono trafia do indeksu i decyduje, czy strona w ogóle zostanie otwarta. |
confidence |
nie | 0.0–1.0. Potwierdzenie przez źródła. Ustawiane przy zapisie, zanika, jeśli nic go nie wzmacnia, rośnie przy nowym zgodnym źródle. |
quality |
nie | 0.0–1.0. Samoocena struktury i cytowań samej strony. Poniżej 0.7 oflagowane do przeglądu. |
supersedes |
nie | Ścieżka do starszej strony, którą ta zastępuje. |
superseded_by |
nie | Ścieżka do nowszej strony, która zastąpiła tę. Zawsze ustawiaj obie strony. |
last_updated |
nie | YYYY-MM-DD. Kiedy zmieniła się strona. |
freshness_window_days |
nie | Liczba dni, po której lint oznacza stronę jako nieaktualną. Typowo: 90 dla strony wiki, 365 dla decyzji, 30 dla dokumentu z indeksu konektora. |
retention |
nie | high / medium / low. Strona low jest archiwizowana (nigdy usuwana) po 2× swoim oknie świeżości. |
source_fingerprint |
nie | (1.5) Skrót źródła, z którego zbudowano stronę — sha256:<8 hex> dla pliku lokalnego albo etag:<wartość> / mtime:<iso8601> dla elementu z konektora. |
source_checked |
nie | (1.5) YYYY-MM-DD — kiedy ten skrót był ostatnio zweryfikowany. To co innego niż last_updated: ponowne sprawdzenie, które nie wykryło zmiany, przesuwa to pole i zostawia last_updated w spokoju. |
review |
nie | (1.6) draft / reviewed / needs_update. Brak pola oznacza „nieśledzone”. ckb-ingest zapisuje draft na nowych stronach i needs_update, gdy zmienia to, co twierdzi strona reviewed; reviewed ustawia tylko decyzja człowieka (przez ckb-lint). |
reviewed_by |
nie | (1.6) Kto ostatnio przejrzał stronę. Zostaje, gdy strona przechodzi w needs_update, jako zapis ostatniego przeglądu. |
reviewed_on |
nie | (1.6) YYYY-MM-DD tego przeglądu. Lint flaguje stronę reviewed, której last_updated jest późniejsze. |
tags |
nie | (1.6) Płaska lista po przecinku, np. tags: retries, billing. Każdy tag musi być wierszem w wiki/tags.md. |
Wyłącznie wiki/index.md niesie kb_schema_version. To deklaracja na
poziomie całego zbioru, nie pojedynczej strony — same strony nigdy jej nie
niosą.
Frontmatter — strony decyzji
Strony z type: decision mieszkają w wiki/decisions/ jako NNNN-slug.md i
dodają:
| Pole | Wymagane | Znaczenie |
|---|---|---|
status |
tak | proposed / accepted / rejected / superseded / reversed. Słownik zdefiniowany w wiki/decisions/index.md i walidowany przez lint. |
decided_on |
dla accepted/rejected/reversed |
YYYY-MM-DD, data podjęcia decyzji. |
decided_by |
gdy wiadomo | Nazwiska po przecinku. Gdy naprawdę nie wiadomo, wpisz unknown zamiast pomijać pole — „nie wiemy, kto to zdecydował" samo w sobie warto zapisać. |
affects |
nie | Ścieżki wiki po przecinku, które ta decyzja ogranicza. |
review_on |
nie | YYYY-MM-DD do ponownego rozważenia. Lint zgłasza je po przekroczeniu daty. |
Rekordy decyzji są tylko do dopisywania. Decyzji nigdy nie przepisuje się pod późniejszą zmianę zdania: zapisz nową, która ją zastępuje, a obie zostają na wokandzie.
Zastrzeżone sekcje treści
(Nowość w 1.5.) Cztery nagłówki ## znaczą to samo na każdej stronie w
każdej warstwie kaskady. Wszystkie są opcjonalne; tam, gdzie występują,
znaczą dokładnie to i nic innego.
## Sources
Skąd wzięła się strona. Po jednym punkcie na źródło, każdy ze skrótem:
## Sources
- `raw/archive/2026-09-21/kickoff-notes.md` — sha256:3f9a2c1e (checked 2026-09-21)
Okno świeżości to przypuszczenie, że źródło mogło się zmienić. Skrót to fakt, czy się zmieniło. Lint przelicza skróty lokalne i oznacza to, co faktycznie się zmieniło — a to inne i pilniejsze znalezisko niż strona, która jedynie się zestarzała.
## Crux
Dosłowne fragmenty tych źródeł — dowód, nigdy parafraza — przypisane do punktu źródła, z którego pochodzą:
## Crux
> FDEs need the VDI *and* a Jira account before day one; the VDI request
> alone takes ten working days.
— `raw/archive/2026-09-21/kickoff-notes.md`, sekcja „Access"
Roboczy zakres to od trzech do dziesięciu linijek. Crux zbliżający się długością do streszczenia nad nim przestał być dowodem i stał się drugą kopią źródła. Z cytowania zamiast parafrazowania wynikają dwie rzeczy: na pytanie często da się odpowiedzieć ze strony zamiast z archiwum, a odpływ od źródła staje się widoczny — streszczenie może po cichu oddalić się od źródła, cytat albo wciąż się zgadza, albo nie.
Strona bez cytowalnego źródła po prostu nie ma ## Crux. Pusty albo
sparafrazowany jest gorszy niż żaden, bo wygląda jak dowód.
## Notes
Pisane przez człowieka i chronione. Żaden skill nie może tej sekcji nadpisać, przeformatować, streścić ani usunąć; regeneracja zachowuje ją co do bajtu.
## Notes
<!-- Twoje. Żaden skill tego nie nadpisuje. -->
Ma to największe znaczenie na stronach, które agent regeneruje — indeksy
konektorów, mapy kodu — gdzie cała reszta jest odrzucana i budowana od nowa
przy kolejnym przebiegu. To jedyne miejsce, w którym adnotacja przetrwa.
Strony decyzji celowo nie mają ## Notes: nic ich nie regeneruje, a rekord
tylko-do-dopisywania ze swobodnie edytowalnym blokiem adnotacji zaprasza
dokładnie do tej wstecznej korekty, której zasada append-only ma zapobiegać.
## Rules
(1.6.) Tylko na stronie zakresu w wiki/projects/: zasady zespołu dla tego
projektu, obowiązujące podczas pracy w tym zakresie. Pisane przez człowieka i
chronione dokładnie jak ## Notes. Ustępują tylko AGENTS.md; profil osoby
ustępuje im.
Znacznik sprzeczności
(1.6.) Nie sekcja, lecz linia w treści, zapisywana tam, gdzie dwa źródła się nie zgadzają, a nikt nie zdecydował, które ma rację:
> CONTRADICTION: three retries (`raw/archive/2026-09-01/kickoff-notes.md`) vs five retries (`raw/archive/2026-11-02/runbook.md`) — found 2026-11-02
Zostaje, dopóki człowiek jej nie rozstrzygnie (supersesja, decyzja albo edycja), a lint wypisuje każdą otwartą (kontrola 18).
Słownik krawędzi
Relacje mieszkają w wiki/graph/edges.json (oraz we własnym
graph/edges.json każdego indeksu konektora). Słownik jest zamknięty, a każdy
czasownik zdefiniowany przez pytanie, na jakie odpowiada — jeśli proponowana
krawędź nie odpowiada na żadne z nich, jej miejsce jest w tekście strony.
| Czasownik | Pytanie, na jakie odpowiada | Od |
|---|---|---|
part_of |
Gdzie to mieszka? Czego jest częścią? | 1.5 |
uses |
Po co to sięga w czasie działania? | 1.1 |
depends_on |
Co się zepsuje, jeśli to zmienię? | 1.1 |
produces |
Skąd bierze się ten wynik? | 1.5 |
configures |
Co zmienia zachowanie tej rzeczy? | 1.5 |
validates |
Co to sprawdza, testuje albo ocenia? | 1.5 |
implements |
Jakiego kontraktu to musi dotrzymać? | 1.5 |
caused |
Dlaczego to się stało? | 1.1 |
contradicts |
Co jest z tym sprzeczne i nierozstrzygnięte? | 1.1 |
supersedes |
Co to zastąpiło i co ono zastąpiło? | 1.1 |
decided_by |
Kto podjął tę decyzję? | 1.4 |
affects |
Co ta decyzja ogranicza? | 1.4 |
has_expertise_in |
Kto potrafi odpowiedzieć na pytania o to? | 1.3 |
owns |
Kto za to odpowiada? | 1.3 |
mentioned_in |
Który dokument źródłowy o tym mówi? | 1.2 (tylko indeksy libs) |
Zapisuj po jednym kierunku na relację — part_of, supersedes,
depends_on i uses są kanoniczne, a odwrotność nie jest przechowywana jako
druga krawędź. Zapisuj krawędzie wyłącznie na podstawie wykazanych dowodów;
brak krawędzi jest lepszy niż krawędź zmyślona, a napompowany graf pogarsza
wyszukiwanie zamiast je poprawiać (stopień wejściowy jest sygnałem
rankingowym).
Zastrzeżony szkielet
| Ścieżka | Od | Do czego służy |
|---|---|---|
wiki/index.md |
1.1 | Tabela routingu; jedyna strona niosąca kb_schema_version |
wiki/overview.md |
1.1 | Mapa KB z lotu ptaka |
wiki/log.md |
1.1 | Dziennik zmian wiki/ w odwrotnej chronologii |
wiki/error-book.md |
1.1 | Problemy systemowe wraz z przyczyną i naprawą |
wiki/entities/ |
1.1 | Typowane strony encji |
wiki/graph/ |
1.1 | edges.json plus słownik w index.md |
wiki/query-gaps.md |
1.2 | Pytania, na które wiki nie umiało odpowiedzieć, napędzające ingest sterowany popytem |
wiki/projects/ |
1.2 | Opcjonalne lokalne zakresy zapytań |
wiki/decisions/ |
1.4 | Numerowane rekordy decyzji tylko-do-dopisywania, z własnym log.md |
wiki/tags.md |
1.6 | Własny zamknięty słownik tagów KB (type: vocabulary); lint sprawdza względem niego tags: |
wiki/topics/ |
1.7 | Podsumowania tematów (type: topic) budowane przez ckb-consolidate, ze skrótami stron członkowskich jako źródłami |
wiki/lessons.md |
1.6 | Lekcje dla całej KB, tworzone przy pierwszym użyciu przez ckb-profile (type: lessons) |
Każdy podkatalog grupujący strony niesie własny index.md, dzięki czemu
nawigacja pozostaje leniwa.
Historia wersji schematu KB
1.7 — 2026-11-02 · podsumowania tematów
D-0016. Nowy opcjonalny
katalog wiki/topics/ z index.md oraz strony type: topic budowane przez
ckb-consolidate z grupy stron członkowskich: ## Summary, ## Members,
## Sources (skróty członków, więc lint wykrywa dryf) i ## Notes.
Addytywnie. Migracja (ckb-upgrade, krok 7 b4): dodać
wiki/topics/index.md i jego wiersz w indeksie, podnieść wersję; żadne strony
tematów nie są generowane.
1.6 — 2026-11-02 · przegląd, sprzeczności, tagi, zasady projektu
Z badania wiedzy dla agentów z 2026-10-31 (funkcje F7, F4, F21, F9, F8), decyzja D-0014. Addytywnie: strona 1.5 jest poprawną stroną 1.6.
- Pola przeglądu
review/reviewed_by/reviewed_on. Plan nazywał jestatus, ale strony decyzji używają jużstatusz innym słownikiem. - Znacznik sprzeczności
> CONTRADICTION: …zamiast cichego zwycięzcy. Daty ważności na poziomie twierdzeń (valid_from/valid_to) odłożone. tagssprawdzane względem nowego pliku szkieletuwiki/tags.md.## Rules, chroniona sekcja na stronach zakresu projektu.wiki/lessons.md, tworzony przy pierwszym użyciu.
Poza wiki/, a więc poza schematem, ale w tym samym wydaniu: profile osób w
workload/profiles/ i skill ckb-profile.
Migracja (ckb-upgrade, krok 7 b3): dodać wiki/tags.md i jego wiersz
w indeksie, podnieść wersję. review uzupełniane tylko na prośbę i tylko do
draft.
1.5 — 2026-09-21 · dowody, skróty źródeł i dokończony słownik krawędzi
Zaadaptowane z analizy trailhq/Graft, warstwy kontekstu dla agentów kodujących, która utrzymuje wyprowadzony graf kodu w zgodzie ze źródłem przez skróty treści, a nie daty, i chroni blok pisany przez użytkownika na każdym regenerowanym węźle. Magazyn Graftu jest jednorazowy i odtwarzalny; ten nie jest, więc większość jego projektu się nie przenosi — ale kilka mechanizmów tak, a dwa z nich zamknęły tu realne luki.
Dodano:
## Crux— dosłowne fragmenty źródeł obok syntezy. Pozwalackb-retrieveugruntować odpowiedź bez powrotu do archiwum (gdy skrót się wciąż zgadza) i czyni odpływ od źródła wykrywalnym.## Notes— pisane przez człowieka i chronione wszędzie. To zamknęło realną lukę:ckb-index-externalregeneruje strony konektora w całości, więc napisana tam adnotacja ginęła dotąd przy kolejnym odświeżeniu.## Sources— sformalizowane jako sekcja zastrzeżona z jednym punktem ze skrótem na źródło. Wcześniej nieformalna konwencja, na którejckb-retrievepolegało, ale której żaden skill faktycznie nie określał.source_fingerprint/source_checkedwe frontmatterze.- Czasowniki krawędzi
part_of,produces,configures,validates,implements.part_ofnaprawiło żywą niespójność:ckb-code-mapzapisywał go od szablonu 1.7.0, a schemat nigdy go nie deklarował.
Zmieniono:
wiki/graph/index.mdprzepisany jako tabela pytanie-na-czasownik wraz z konwencjami dotyczącymi kierunku krawędzi i dowodów.ckb-ingestdostał krok promienia rażenia: przed zapisem przejdź graf wstecz od dotkniętych encji, żeby ustalić, co nadchodzący materiał potwierdza, rozszerza albo z czym jest sprzeczny, i wskaż właścicieli dotkniętych stron. Ingest był dotąd przede wszystkim addytywny, a tak właśnie wiki gromadzi dwie strony, które po cichu się ze sobą nie zgadzają.ckb-retrievewtapia stopień wejściowy grafu jako jedną z rankowanych list, z wagą poniżej 1.0 — centralność jest przesłanką, nie dowodem.- Reguła E (start sesji) uruchamia teraz
lint_report.py --quickobokgit status: deterministyczny jednoliniowy sygnał gnicia wiedzy, niekosztujący żadnych tokenów modelu. - Lint zyskał kontrole 12 (odpływ skrótu źródła), 13 (dosłowność sekcji Crux)
i 14 (zasada chronionego
## Notes).
Kompatybilność: w pełni addytywna. Strona 1.4 bez żadnej z nowych sekcji
i pól jest poprawną stroną 1.5. Migracja nigdy nie wytworzy ## Crux —
zmyślanie cytatów to dokładnie ta porażka, której ta sekcja ma zapobiegać.
1.4 — 2026-09-01 · rekordy decyzji
Dodano: strony type: decision w wiki/decisions/ jako NNNN-slug.md,
z status, decided_on, decided_by, affects, review_on; czasowniki
krawędzi decided_by i affects; wiki/decisions/index.md wraz z własnym
log.md; zasadę append-only. Odpowiada na „dlaczego jest tak, jak jest",
„kto zdecydował" i „co zmieniło tę decyzję" bezpośrednim wyszukaniem zamiast
zgadywania pełnotekstowego. Właścicielem jest skill ckb-decide.
1.3 — 2026-08-06 · krawędzie osoba–temat
Dodano: czasowniki krawędzi has_expertise_in i owns, dzięki którym
„kto wie o X" i „kto jest właścicielem X" to wyszukanie w grafie, a nie
przeszukiwanie pełnotekstowe. Zapisywane wyłącznie na podstawie wykazanych
dowodów — obecność na spotkaniu to nie ekspertyza, a stanowisko to nie
własność.
1.2 — 2026-07-29 · zakresy zapytań, luki i libs oparte na konektorach
Dodano: wiki/projects/ (opcjonalne lokalne zakresy zapytań grupujące
powiązane strony, źródła i obszary grafu); wiki/query-gaps.md (nieudane
wyszukiwania zapisane jako przyszłe cele ingestu);
raw/archive/<YYYY-MM-DD>/ jako utrzymywane przez agenta miejsce
archiwizacji; libs/<name>/ oparte na konektorach, z pisanym przez
użytkownika source.yaml, należącym do agenta generowanym indeksem oraz
czasownikiem krawędzi mentioned_in używanym wewnątrz tych indeksów.
1.1 — 2026-07-13 · pierwszy schemat
Pierwszy wersjonowany kontrakt, wydany wraz z pierwszym commitem. Ustanowił
zestaw pól frontmatteru (type, resource, tldr, confidence, quality,
supersedes/superseded_by, last_updated, freshness_window_days,
retention), podstawowe czasowniki krawędzi (uses, depends_on, caused,
contradicts, supersedes), szkielet wiki/, zasadę priorytetu kaskady i
rekurencyjną konwencję indeksu i dziennika.
Wersji 1.0 nigdy nie było: wersjonowanie zaczęło się od pierwszego opublikowanego schematu.
Historia wersji szablonu
Warstwa narzędziowa — AGENTS.md/CLAUDE.md, skille, skrypty, dokumentacja.
Niezależna od schematu treści powyżej.
| Wersja | Data | Co weszło | Schemat |
|---|---|---|---|
| 2.0.1 | 2026-11-11 | Poprawki z przeglądu skryptów 2.0.0, bez nowych funkcji. Znów Python 3.8: removeprefix/removesuffix (3.9+) zastąpione w lint_report.py, retrieve_candidates.py, consolidate.py i serwerze mcp; na 3.8 każda KB z wiki/graph/edges.json wywracała lint, kontrolę na starcie sesji, wyszukiwanie i konsolidację. routines.py --mark nie zapisuje już last_run:2026-… bez spacji (niepoprawny YAML dla każdego prawdziwego parsera) w świeżo dodanej rutynie i zostawia końcowy komentarz komentarzem, zamiast doklejać go do wartości. Eksporty nie wychodzą poza swój folder: export_okf.py --out musi wskazywać folder wewnątrz outputs/ (jest usuwany i budowany od nowa; --out . usuwało repozytorium), a export_starlight.py kopiuje obraz tylko z wnętrza wiki/assets/ do własnych zasobów, więc ../assets/../../x w treści strony nie może już czytać ani zapisywać plików gdzie indziej. Dokumentacja: skrypt ma osiem skilli rdzenia (brakowało ckb-consolidate, ckb-routine, ckb-add-conversation) w AGENTS.md, obu README i obu podręcznikach. Nowy tests/unit/ (unittest z biblioteki standardowej, uruchamiany przez smoke.sh): statyczna straż Pythona 3.8 nad każdym dostarczanym skryptem, przebiegi routines.py, ograniczenie eksportów do ich folderu i zgodność AGENTS.md ze skillami na dysku |
1.7 |
| 2.0.0 | 2026-11-11 | Zmiana przełomowa: koniec obsługi PowerShella (D-0019). Usunięte: ckb-lint/scripts/lint_quick.ps1, porównanie wersji w PowerShellu w kroku 2 ckb-upgrade i każda wzmianka „albo .ps1” (AGENTS.md reguła E i §3, ckb-lint, jego ręczna lista kontrolna, ckb-sync-changes, oba README i oba podręczniki). Bez Pythona zapasową kontrolą na starcie sesji jest lint_quick.sh, na Windows w Git Bash. Każdy skrypt szablonu i jego modułów jest w Pythonie (AGENTS.md §3); lint_quick.sh i kontenerowy entrypoint.sh modułu mcp to nazwane wyjątki. KB, które potrzebują PowerShella, zostają na gałęzi 1.x („przełącz tę KB na gałąź 1.x”), która dostaje tylko poprawki. ckb-upgrade usuwa teraz pliki, które źródło usunęło z folderu skilla lub modułu, który nadal dostarcza; krok 5 wypisuje je jako Removed files. Bez zmiany schematu |
1.7 |
| 1.28.1 | 2026-11-11 | Kanał wydawniczy 1.x: gałąź utrzymaniowa linii 1.x po wydaniu 2.0, tylko poprawki, ostatnia z obsługą PowerShella (D-0019). Dopisany do tabel kanałów w ckb-init, ckb-upgrade, AGENTS.md, obu README i obu podręcznikach oraz do komentarza w ckb.yaml. ckb-upgrade krok 2: wyższa wersja główna w źródle zatrzymuje przebieg przed krokiem 4, cytuje przełomową część wiersza changeloga i proponuje nową wersję główną albo przejście na gałąź utrzymaniową; nigdy nie przechodzi przez nią z rutyny ani trybu wsadowego |
1.7 |
| 1.28.0 | 2026-11-11 | Nowy opcjonalny moduł share (D-0018): skill ckb-share i share.py (join/send/unshare/list/receive/status, biblioteka standardowa + git). Kanał to osobne repozytorium git na grupę zaufania z CHANNEL.md, members.yaml (baza → e-maile właścicieli) i jedną skrzynką tylko do dopisywania na bazę, mail/<baza>/, klonowane do tmp/share/<kanał>/. Wysyłka pakuje samodzielną kopię strony z outputs/documents/, outputs/answers/ lub wiki/ (raw/archive/ tylko z --raw-ok): bez fragmentów <private> i ## Notes, linki lokalne jako tekst, ścieżki w Sources/Crux oznaczone <baza>:; koperta type: share, kind, share_id, version, from, to, sent_by, untrusted: true; wzorce sekretów z lintu blokują wysyłkę (kod 3), próba pokazuje sekcję wrażliwości z ABOUT.md, użytkownik potwierdza. Ponowna wysyłka tworzy kolejną wersję. Odbiór kopiuje wiadomości do bazy do raw/inbox/ z share_channel, share_ref, received_on, submitted_by (autor w gicie) i supersedes_source; wiadomość, której autor nie jest właścicielem skrzynki, jest NIEZWERYFIKOWANA i brana tylko z --accept-unverified; wycofanie staje się żądaniami w raw/retractions/ dla każdej posiadanej wersji. Rejestr received: w należącym do skryptu bloku share: w ckb.yaml nie pozwala obsłużonym wiadomościom wrócić. dedup_inbox.py zgłasza SAME SHARE; ckb-ingest i ckb-retract znają pliki i żądania z share. Test dymny obejmuje dwie bazy i kanał na gołym repozytorium od początku do końca |
1.7 |
| 1.27.0 | 2026-11-02 | Nowy skill bazowy ckb-feynman, zaadaptowany ze skilla feynman z superhero-tech-super-brain: wyjaśnia jedną stronę prostymi słowami na konkretnym przykładzie, z linią → [[page]] · [Tytuł § Nagłówek](/wiki/…#kotwica) pod każdym fragmentem, potem przypisuje każde rozrzedzone miejsce do luk Wiki, Źródła lub Moje, nie łatając żadnej wiedzą modelu, prosi o wyjaśnienie z powrotem i kończy ponumerowanymi kolejnymi krokami. Kandydaci to strony review: draft/needs_update, z jednym źródłem, nieaktualne lub ze sprzecznością; strony tematyczne prowadzą do stron członkowskich; odciski Crux sprawdzane jak w kroku 6 ckb-retrieve; fragmenty <private> nigdy nie są wyjaśniane. Sesje trafiają do outputs/teaching/feynman/YYYY-MM-DD_<slug>.md (type: feynman-session, ## Sources z odciskami, ignorowane przez gita razem z outputs/teaching/, bez wpisu w wiki/log.md); luka w źródłach trafia do wiki/query-gaps.md tylko po zgodzie. ckb-teach-me pomija ten folder; zaktualizowane ckb-init, wiersz routingu w AGENTS.md, oba README i oba podręczniki; przypadek eval ckb-feynman/session z zapisanym przebiegiem wzorcowym (6/6). outputs/teaching/ dodane do kontraktu katalogów; run_evals.py dopasowuje usunięte pliki semantyką glob (** było jednym segmentem) |
1.7 |
| 1.26.2 | 2026-11-10 | ABOUT.pl.md: polska para szablonu ABOUT.md, jak pozostałe dokumenty .pl.md. Gdy oba są wypełnione, agent czyta oba, a przy rozbieżności wygrywa ABOUT.md (AGENTS.md, ckb-ingest); ckb-init kopiuje oba i wpisuje odpowiedź po polsku do polskiego pliku; ckb-upgrade tworzy go raz w KB poniżej 1.26.2 i nigdy nie odtwarza usuniętego; ckb-reset go nie rusza; w module mcp kb_overview go zawiera, a opis serwera bierze jego tldr, pomijając oba placeholdery. README.pl.md i QUICKSTART.pl.md do niego odsyłają; oba podręczniki go wymieniają |
1.7 |
| 1.26.1 | 2026-11-02 | Dokumentacja: jednostronicowy szybki start, docs/QUICKSTART.md i docs/QUICKSTART.pl.md, od pustego folderu do pierwszego ingestu, odpowiedzi, lintu i synchronizacji; linki z obu README i obu podręczników |
1.7 |
| 1.26.0 | 2026-11-02 | Wiedza dla agentów, wydanie 3, partia 3 (D-0017). Moduł capture (F11): nowy opcjonalny .agents/modules/capture/ ze skillem ckb-capture i capture_url.py: link staje się plikiem raw/inbox/YYYY-MM-DD_<slug>.md (type: capture, source_url, fetched_on, fetched_via, untrusted: true, baner) z pobrania biblioteką standardową z wydobyciem czytelnego tekstu; najbliższy zrzut Wayback Machine jest używany tylko, gdy żywa strona zawiodła lub była uboższa; --from-file opakowuje tekst pobrany przez samego agenta; PDF-y są zapisywane jako pliki; --media zapisuje transkrypcję ze znacznikami czasu przez yt-dlp, tylko za zgodą; jedna ponowna próba przy 429/503. dedup_inbox.py porównuje source_url zrzutu z zarchiwizowanymi zrzutami i bliźniakami w skrzynce, a capture usuwa własny duplikat. Ewaluacje skilli (F22): tests/run_evals.py (list/prepare/check/validate) i pięć strukturalnych przypadków w tests/evals/ (ingest wsadowy, retrieve bez odpowiedzi i z zachowaniem odpowiedzi, decide, retract), z zapisanym przebiegiem wzorcowym dla ckb-decide/record (7/7). Wielu agentów (F18): sekcja podręcznika z nieprzetestowanymi konfiguracjami dla Codex CLI, Cursor, OpenCode i Gemini CLI oraz tabelą funkcji tylko dla Claude Code; AGENTS.md każe agentom bez wczytywania skilli czytać SKILL.md. Test dymny obejmuje capture z lokalnym serwerem i zastępczym Wayback oraz runner ewaluacji w obie strony |
1.7 |
| 1.25.0 | 2026-11-02 | Wiedza dla agentów, wydanie 3, partia 2: utrzymanie, schemat 1.7 (D-0016). Nowy skill ckb-consolidate z consolidate.py: raport samych propozycji w outputs/reports/YYYY-MM-DD_consolidation.md z grupami tematów (członkowie zakresu, wspólne tagi, połączone grupy od trzech stron) i stanem każdej strony tematu (brak, aktualna, nieaktualna), kandydatami do scalenia (ten sam typ, podobieństwo tytułu/tldr ≥ 0,5), brakującymi linkami (dwa wspólne źródła albo jedno plus wspólny zakres), stronami nieaktualnymi lub z dryfem z lintu i starymi wpisami dziennika według miesięcy (dziennik nigdy nie jest przepisywany) (F13). Strony tematów (type: topic) w nowym wiki/topics/, budowane tylko po akceptacji, ze skrótami stron członkowskich w ## Sources, więc lint wykrywa dryf; ckb-retrieve kieruje pytania „co KB mówi ogólnie” najpierw do wiki/topics/index.md (F15). ckb-upgrade b4, ckb-init, ckb-reset znają wiki/topics/; ckb-routine podsuwa rutynę Consolidate --confirm co 14 dni. Test dymny obejmuje grupowanie, stany tematów i raport |
1.7 |
| 1.24.0 | 2026-11-02 | Wiedza dla agentów, wydanie 3, partia 1: wyszukiwanie (D-0015). Wyszukiwanie po sekcjach (F10): retrieve_candidates.py dodaje listę bm25 z indeksu SQLite FTS5 (biblioteka standardowa) po sekcjach stron, z tytułem strony, ścieżką nagłówków i tldr w osobnej kolumnie kontekstu (contextual retrieval); pamięć podręczna tmp/ckb-fts.sqlite odświeża się po mtime, potem sha256 (w pamięci bez tmp/, pomijana bez FTS5); kandydaci wymieniają do trzech trafionych sekcji #kotwica (Nagłówek). Nowy benchmark tests/bench_retrieval.py na tests/fixtures/bench-kb/ (12 stron, 20 pytań): hit@1 14/20 i hit@3 20/20 z bm25 i bez. Waga zostaje 1.0, bez strojenia pod zestaw; chybienia biorą się z sygnału tldr, który łapie ogólne słowa. Koszt w tokenach (F12): ~N tok przy każdym kandydacie; skill czyta indeks → sekcja → strona. Dziennik odczytów (F16): --opened ŚCIEŻKA… dopisuje przeczytane strony do tmp/access.log (per maszyna); lint_report.py --cold [DNI] proponuje przeniesienie nieczytanych stron do sekcji ## Archive indeksu i niczego nie przenosi. Formaty odpowiedzi (F17): ckb-retrieve raz proponuje tabelę, wykres, prezentację lub stronę HTML, gdy odpowiedź ma taki kształt. Test dymny obejmuje pamięć indeksu, trafienia sekcji, dziennik odczytów, propozycje --cold i benchmark |
1.6 |
| 1.23.0 | 2026-11-02 | Wiedza dla agentów, wydanie 2, schemat 1.6 (D-0014). Przegląd (F7): opcjonalne `review: draft | reviewed |
| 1.22.1 | 2026-11-02 | Hooki startują z katalogu głównego projektu. Claude Code uruchamia hook w bieżącym katalogu sesji, więc względna ścieżka save_conversation.py w hooku autozapisu Stop rozwiązywała się względem folderu, do którego przeszła powłoka: sesja pracująca w zagnieżdżonym repozytorium zapisywała tam swój transkrypt, a w folderze bez skryptu zapis cicho się nie udawał. autosave_hook.py i start_hook.py zapisują teraz cd "${CLAUDE_PROJECT_DIR:-.}" && …; --check zgłasza wpis zainstalowany przed tą poprawką jako nieaktualny (podsumowanie startu sesji pyta raz), a --install podmienia go, nie ruszając innych hooków. Test dymny uruchamia oba zainstalowane hooki z podfolderu |
1.5 |
| 1.22.0 | 2026-11-02 | Wiedza dla agentów, wydanie 1: siedem funkcji z badania z 2026-10-31, bez zmiany schematu. Hook startu sesji (F1): session_start.py --hook wypisuje podsumowanie z reguły E jako additionalContext hooka SessionStart przy starcie, wznowieniu, /clear i po każdym kompaktowaniu; start_hook.py --check/--install/--remove zarządza nim w ignorowanym przez gita .claude/settings.local.json; włączany przez session: start_hook: w ckb.yaml, z linią start hook: w podsumowaniu, gdy oba się nie zgadzają; reguła E zostaje jako zapas (D-0011). Zachowane odpowiedzi (F2): krok 8 ckb-retrieve proponuje zachowanie istotnej odpowiedzi w outputs/answers/ (type: answer) ze skrótami w ## Sources i sekcją ## Gaps, aktualizuje zamiast dublować i wprowadza do wiki tylko przez ingest; kontrola 16 lintu zgłasza zachowane odpowiedzi, których źródła się zmieniły (D-0013). Meldunek przed ingestem (F3): zanim cokolwiek zapisze, ckb-ingest pokazuje, jak rozumie każde źródło, które strony zmieni i z czym jest sprzeczne, po czym czeka; tryb wsadowy („ingest in batch” albo rutyna z confirm: false) to pomija; raport ingestu dostaje sekcję ## Check-in. Otwarte wątki (F5): pola ### Open threads w notatkach workload (reguła D), zbierane przez session_start.py w linię threads: z pięcioma najstarszymi i znacznikiem po 30 dniach; bez wspólnego pliku statusu (D-0012). Deduplikacja przy wejściu (F6): nowy ckb-ingest/scripts/dedup_inbox.py zgłasza DUPLICATE, SAME TEXT, CITED, SAME URL i INBOX TWIN względem raw/archive/ oraz cytowanych skrótów i adresów URL przed ingestem. Ochrona sekretów i prywatności (F19): kontrola 15 lintu szuka postaci danych uwierzytelniających w commitowanym tekście i fragmentów <private> w wiki/, maskuje dopasowania, honoruje .secrets-allow oparte na skrócie linii; --quick ją liczy, --secrets uruchamia ją osobno, a ckb-sync-changes przed stagingiem; ingest odrzuca, a retrieval nigdy nie cytuje fragmentów <private>; save_conversation.py je redaguje (D-0013). Budżet kontekstu (F20): lint_report.py --budget szacuje AGENTS.md plus opisy skilli jako znaki ÷ 4; --quick flaguje przekroczenie budget: always_loaded_tokens (domyślnie 9000). Punkt odniesienia: ~6 620 tokenów w 1.21.0, ~6 810 w 1.22.0. Zapasowe kontrole bash/PowerShell dostają okrojoną kontrolę sekretów; test dymny obejmuje każdy nowy skrypt |
1.5 |
| 1.21.0 | 2026-10-31 | ABOUT.md. Nowy plik w katalogu głównym, pisany przez właściciela KB, mówiący, co ta KB zawiera: cel, odbiorcy, zakres (co wchodzi, a co nie), właściciele i kontakty, oczekiwane źródła, poufność, język i terminy; każda sekcja ma komentarz, co w niej napisać; type: about z tldr. README.md/README.pl.md linkują do niego pod wskazaniem repozytorium źródłowego, bo samo README należy do szablonu i jest nadpisywane przy aktualizacji. Agenci go czytają i nie edytują bez prośby; pytania o samą KB dostają odpowiedź najpierw z niego, potem z wiki/overview.md, które pozostaje podsumowaniem agenta tego, co przetworzono, i teraz do niego linkuje. ckb-ingest w Kroku 1 wskazuje materiał spoza zakresu lub wykluczony przez sekcję poufności i przetwarza go tylko na wyraźną prośbę. ckb-init kopiuje szkielet i zadaje jedno opcjonalne pytanie o cel i tldr; ckb-upgrade tworzy go tylko, gdy go brak, i nigdy go nie porównuje; ckb-reset nigdy go nie rusza. Moduł mcp: kb_overview zaczyna się od niego, a opis KB serwera pochodzi z jego tldr (zastępczy tekst szkieletu jest pomijany). Zaktualizowano kontrakt katalogów i podręcznik. D-0010 |
1.5 |
| 1.20.0 | 2026-10-30 | Raporty z ingestu. ckb-ingest dostaje Krok 8: każde uruchomienie, które coś przetworzyło, zapisuje jeden plik workload/ingest-reports/YYYY-MM-DD_HHMM_<autor>_ingest.md (type: ingest-report) z listą przyjętych plików z raw/ wraz ze ścieżką archiwum i odciskiem, zapisanych decyzji, utworzonych/zaktualizowanych encji, innych stron, krawędzi grafu, zasięgu zmian (potwierdzone/rozszerzone/sprzeczne z właścicielami, zamknięte luki w zapytaniach) oraz plików ze skrzynki, których nie przetworzono; każda sekcja zostaje, z - none, gdy jest pusta. Zapisywany raz, poza wyszukiwaniem, bez wpisu w wiki/log.md, nieruszany przez ckb-retract; podfolder, aby session_start.py nadal czytał tylko notatki sesji. Dotychczasowy Krok 8 (podsumowanie i przypomnienie o synchronizacji) staje się Krokiem 9 i wskazuje raport. Zaktualizowane: struktura katalogów, podręcznik i poziom 2 w ckb-reset |
1.5 |
| 1.19.0 | 2026-10-29 | Mniej kontekstu na sesję i na skill. Nowy ckb-lint/scripts/session_start.py wykonuje start sesji z Reguły E jednym wywołaniem (tożsamość, --title zapisywany, chyba że tytuł już jest, announce_title, git status, lint_report.py --quick, autosave_hook.py --check tylko gdy wymaga działania, routines.py --due oraz ostatni blok najnowszej notatki workload/ zamiast całego pliku); Reguła E w AGENTS.md skraca się do polecenia i tego, co zrobić z każdą linią wyniku. Odczyt wiki/index.md na starcie sesji usunięty: każdy skill, który potrzebuje indeksu, czyta go sam, więc był czytany dwa razy. ## Purpose każdego skilla ograniczone do tego, czego nie mówi już jego opis (16,2k → 7,8k znaków w dwudziestu skillach). ckb-upgrade nie powtarza już formatu wpisu dziennika z Reguły B. Test dymny obejmuje nowy skrypt. D-0009 |
1.5 |
| 1.18.1 | 2026-10-29 | Poprawki po przeglądzie. Tryb sync modułu mcp: sprawdzenie czystego katalogu roboczego działa teraz przed każdym resetem, nie tylko przy starcie, więc strona edytowana lub plik wrzucony do klonu serwera po jego uruchomieniu nigdy nie zostanie skasowany: odczyt pomija pobranie i serwuje katalog bez zmian, zapis jest odrzucany z jasnym komunikatem, a pozostałości po nieudanym zapisie samego serwera nadal są usuwane. Niedostępne zdalne repozytorium przy starcie albo przekroczony czas wywołania git to teraz jedna linia z przyczyną zamiast śladu stosu. ckb-retract: opiekun bazy może wycofać źródło dodane przez kogoś innego, wyłącznie w sesji lokalnej, po wpisaniu retract <nazwa pliku> as maintainer; każdy wpis w logu z takiego przebiegu jest oznaczony jako obejście, bo baza służy dzieleniu się wiedzą i źródło nie może utknąć, gdy jego autor odejdzie lub zmieni adres e-mail. Klienci zdalni nadal mogą wycofywać tylko własne źródła. Prośba, której cel już nie istnieje, jest usuwana i zgłaszana, jeśli nic go już nie cytuje. ckb-document: komentarze szablonu z linked/ kształtują tylko treść, nigdy działania. Przewodnik MCP: prośbę o wycofanie widzi konto, które ją złożyło, a nie „tylko ty”. D-0007 |
1.5 |
| 1.18.0 | 2026-10-29 | Szablony dokumentów. Nowy katalog główny templates/ (treść użytkownika: poza kaskadą, poza warstwą szablonu, nigdy nie resetowany): jeden plik Markdown na szablon z frontmatterem type: template, nagłówki nadają kształt, komentarz HTML pod każdą sekcją jest instrukcją dla agenta (zapytaj użytkownika, wskazane źródło, długość, kiedy pominąć sekcję), {{date}}/{{author}}/{{slug}} wypełniane automatycznie, każdy inny placeholder pytany raz, opcjonalna ścieżka output:. Nowy skill bazowy ckb-document: znajduje szablon po nazwie, tytule lub tldr (linked/<name>/templates/ tylko do odczytu jako zapas), zadaje wszystkie pytania w jednej wiadomości, źródła rozwiązuje przez kaskadę od indeksu, zapisuje do outputs/documents/ z frontmatterem type: document (template, created, author, sources), zostawia linię TODO: tam, gdzie brakuje źródła lub odpowiedzi, nigdy nie nadpisuje, inne formaty przez ogólne skille dokumentowe z Markdowna; na prośbę wypisuje szablony i przygotowuje szkic nowego. Przykład templates/status-report.md i templates/README.md; kopiowane przez ckb-init, tworzone przez ckb-upgrade tylko gdy katalogu brak, pomijane przez ckb-reset. D-0008 |
1.5 |
| 1.17.0 | 2026-10-29 | Nowy opcjonalny moduł mcp: serwer MCP (.agents/modules/mcp/server/) udostępniający bazę aplikacjom Claude (web/desktop) jako własny konektor, Claude Code lub dowolnemu klientowi MCP. Odczyt: kb_overview, search_kb (uruchamia retrieve_candidates.py), read_page, list_pages na wiki/, linked/, libs/, raw/inbox/, raw/archive/, outputs/ (te same obszary w każdej bazie podlinkowanej; poza linked/<name> żaden symlink nie jest śledzony) oraz własne prośby w raw/retractions/. Zapisy nigdy nie dotykają wiki/: add_to_inbox (nowy plik w raw/inbox/ z submitted_by/submitted_at/via: mcp/source, autor w git to zgłaszający), withdraw_submission i request_retraction — tylko dla osoby, która dodała dokument — oraz list_my_submissions. Każdy zapis wymaga argumentu kb zgodnego z serwerem, a przy CKB_MCP_CONFIRM=auto potwierdza go użytkownik (elicitation MCP u klientów 2026-07-28, w pozostałych przypadkach podpisany, ważny 15 minut kod w drugim wywołaniu); wywołujący tylko do odczytu nie widzą narzędzi zapisu. Uwierzytelnianie `CKB_MCP_AUTH=none |
token |
| 1.16.1 | 2026-10-24 | Pytanie o tytuł znika: agent sam wyprowadza tytuł sesji z pierwszej wiadomości, zapisuje go przez --set-title, a pierwsza odpowiedź zaczyna się tylko jedną linijką z tytułem i sposobem zmiany. conversations.announce_title (domyślnie true) zastępuje ask_title. D-0006 |
1.5 |
| 1.16.0 | 2026-10-21 | Tytuły sesji i rutyny. Pierwsza odpowiedź w nowej sesji (Reguła E) to pytanie „Jak nazwać tę rozmowę?” (przełącznik conversations.ask_title, domyślnie true); odpowiedź zapisuje save_conversation.py --set-title w ignorowanym przez gita tmp/conversation-titles/ i nadaje nazwę zapisanemu transkryptowi (slug, nagłówek, wiersz indeksu) oraz blokowi w workload; ponowny zapis pod nowym tytułem zastępuje starą parę plików. Nowy ckb-routine: blok routines: w ckb.yaml (name/do/every/confirm/last_run), sprawdzany na starcie sesji przez routines.py --due; zaległe rutyny wykonują się po obsłużeniu prośby użytkownika w tej samej turze i są oznaczane --mark tylko po ukończeniu, confirm: true zamiast tego pyta, ręczne uruchomienia się liczą, ckb-reset/ckb-sync-changes odrzucane. ckb-init zapisuje oba bloki, ckb-upgrade ich nie rusza; test dymny obejmuje oba skrypty. D-0005 |
1.5 |
| 1.15.0 | 2026-10-16 | tests/ tylko w repo szablonu: ckb-init już go nie kopiuje, ckb-upgrade go nie dostarcza (i raz proponuje usunięcie pozostałej kopii), kontrakt katalogów i dokumentacja o tym mówią. Sam test dymny bez zmian |
1.5 |
| 1.14.0 | 2026-10-16 | Autorstwo we współdzielonych repozytoriach: tożsamość sesji (git config user.name/user.email, ustalana raz na starcie) opisuje każdą notatkę workload, każdy wpis wiki/log.md (nowa linia **Author:**, opcjonalna, neutralna dla lintu) i każdą zapisaną rozmowę (save_conversation.py --author). Pliki workload stają się jednym na osobę na dzień, YYYY-MM-DD_<autor>_summary.md z frontmatterem type: session, więc dwie osoby nigdy nie konfliktują w workload/; starsze pliki czytane jak dotąd. D-0004 |
1.5 |
| 1.13.0 | 2026-10-16 | Przełącznik autozapisu rozmów: conversations.autosave w ckb.yaml (domyślnie false). Po włączeniu Reguła E zapisuje każdą sesję na jej końcu bez pytania; ckb-add-conversation przełącza go na żądanie („save conversations automatically”). Połowa per maszyna: autosave_hook.py --check/--install/--remove zarządza hookiem Stop Claude Code w ignorowanym przez gita .claude/settings.local.json; Reguła E uruchamia kontrolę na starcie sesji przy włączonym autozapisie i pyta przed zmianą konfiguracji maszyny; save_conversation.py --from-hook bierze ścieżkę transkryptu ze stdin hooka. ckb-init zapisuje blok, ckb-upgrade go nie rusza |
1.5 |
| 1.12.0 | 2026-10-16 | ckb-add-conversation: na żądanie kopiuje transkrypt sesji Claude Code (JSONL, bajt w bajt) do raw/saved-conversations/<data>/ wraz z czytelną wersją .md i index.md; odpowiada na „did we discuss X” / „what did I tell you about Y” z tych plików. Zapisane rozmowy są poza wyszukiwaniem i poza ingestem, dopóki użytkownik nie skopiuje jednej do raw/inbox/. Reguła E pyta raz na końcu sesji, czy zapisać; ckb-retrieve, ckb-ingest, ckb-reset (poziom 3) i ckb-init znają ten folder; test smoke renderuje transkrypt z fixture |
1.5 |
| 1.11.1 | 2026-10-09 | Pięć usterek naprawionych, wszystkie zgłoszone przez KB pochodną. retrieve_candidates.py: load_pages przechodzi katalogi w kolejności posortowanej, więc oczekiwany wynik testu nie koduje już kolejności katalogów jednej maszyny (test smoke nie przechodził na czystym klonie); źródło cytowane przez N stron potwierdza teraz wszystkie N, a nie tylko pierwszą napotkaną. lint_report.py kontrola 12: cytowany katalog jest legalny i bez skrótu, nie jest już zgłaszany jako brakujący (ta sama poprawka w lint_quick.sh/.ps1). Kontrola 8: POINTER w dzienniku głównym nie jest już czytany jako duplikat wpisu dziennika decyzji, na który wskazuje. Kontrola 13: cytat przypisany do rozmowy lub osoby liczy się jako przypisany, nie jako nieprzypisany. AGENTS.md §2 dokumentuje cytowanie katalogów i dwie formy atrybucji; KB testowy pokrywa wszystkie trzy regresje lintu |
1.5 |
| 1.11.0 | 2026-09-29 | Python opcjonalny tam, gdzie to możliwe: wybór interpretera <python> (python3/python/py -3) w AGENTS.md; instrukcja instalacji per system w podręczniku; zapasowe lint_quick.sh/.ps1 dla kontroli na starcie sesji (testowane smoke wobec --quick); ręczna lista kontrolna lintu i ścieżka wyszukiwania bez skryptu; eksporty deklarują Pythona jako wymóg twardy; usunięte wbudowane python3 -c z ckb-upgrade/ckb-reset; D-0003. Kontrola lintu 13 porównuje każdy blok Crux tylko ze źródłem przypisanym pod nim (Crux z wielu źródeł już nie daje fałszywych wyników; cytaty łamane na kilka linii sprawdzane jako jeden blok); KB testowy zyskuje drugie źródło |
1.5 |
| 1.10.0 | 2026-09-24 | Odchudzone opisy i treści skilli (przypadki brzegowe → references/); retrieve_candidates.py przejmuje fuzję rankingów; dokumentacja przeniesiona do docs/, ADR-y szablonu przywrócone w docs/decisions/; fixture tests/ + smoke.sh; dołączony ckb.yaml; Reguła B nazywa wyjątek dziennika decyzji; szkieletowy overview.md opisuje treść, nie schemat; usunięty wyzwalacz „Sync the wiki” |
1.5 |
| 1.9.0 | 2026-09-22 | Kanały wydawnicze: gałęzie main/test/experimental, świadome gałęzi ckb-init i ckb-upgrade, blok template: w ckb.yaml |
1.5 |
| 1.8.0 | 2026-09-21 | Siedem pomysłów zaadaptowanych z Graftu: crux/notes/skróty źródeł, tryb --quick lintu, ranking po stopniu wejściowym, promień rażenia w ingeście, dokończony słownik krawędzi |
→ 1.5 |
| 1.7.0 | 2026-09-20 | Opcjonalne moduły (.agents/modules/, ckb-module, ckb.yaml); moduł software z ckb-code-map i ckb-spec; ckb-reset; dokumentacja OpenSpec |
1.4 |
| 1.6.1 | 2026-09-01 | Naprawa fałszywie dodatnich znalezisk uszkodzonych krawędzi w kontroli grafu | 1.4 |
| 1.6.0 | 2026-09-01 | ckb-decide; wykrywająca połowa lintu przeniesiona do lint_report.py; eksport OKF przeniesiony do export_okf.py |
→ 1.4 |
| 1.3.0 | 2026-08-06 | Fuzja rankingów, deduplikacja i ponowny ranking w ckb-retrieve; wyszukiwanie ekspertyzy i własności |
→ 1.3 |
| 1.2.1 | 2026-07-29 | AGENTS.md skompresowany — przepływy przeniesione do skilli, zostawiając mały, zawsze ładowany zestaw reguł |
1.2 |
| 1.2.0 | 2026-07-29 | Zakresy projektów, luki zapytań, wyszukiwanie weryfikowane względem źródła | → 1.2 |
| 1.1.0 | 2026-07-20 | libs/ oparte na konektorach z samodzielnym indeksowaniem źródeł zewnętrznych (ckb-index-external) |
1.1 * |
| 1.0.0 | 2026-07-17 | Pierwszy otagowany szablon: pełny zestaw skilli, LICENSE, MANUAL, dokumentacja dwujęzyczna |
1.1 |
* libs/ oparte na konektorach weszły jako narzędzia w 1.1.0, ale schemat
zapisał je — kontrakt source.yaml, kształt generowanego indeksu, czasownik
mentioned_in — dopiero w 1.2, dziewięć dni później. Takie doganianie się
tych dwóch numerów jest normalne i dlatego kolumna schematu pokazuje, co
obowiązywało po danym wydaniu szablonu, a nie czego to wydanie dotyczyło.
Wersje 1.4.0 i 1.5.0 nigdy nie zostały opublikowane — szablon przeskoczył z 1.3.0 na 1.6.0 dnia 2026-09-01.
Kanały wydawnicze
Repozytorium szablonu utrzymuje trzy gałęzie, a powyższe historie wersji
śledzą wyłącznie main:
| Gałąź | Czym jest | Kto powinien ją śledzić |
|---|---|---|
main |
Stabilna — wydany szablon | Wszyscy, domyślnie |
test |
Kandydat do wydania — walidowany przed scaleniem do main |
Każdy, kto pomaga walidować wydanie |
experimental |
Rozwojowa — bieżąca praca, może być zepsuta albo wycofana | Osoby rozwijające sam szablon |
Śledzona przez KB gałąź mieszka w ckb.yaml:
template:
repo: https://git.wierzbowa.cloud/michal/ckb.git
branch: main
ckb-init ją zapisuje, ckb-upgrade czyta ją jako domyślną i aktualizuje przy
przełączeniu. Brak ckb.yaml i brak bloku template: oznaczają main.
Jedna konsekwencja warta poznania: KB, która wzięła narzędzia z test albo
experimental, może mieć VERSION wyższą niż to, co main w ogóle wydało.
Porównanie z main nie znajdzie wtedy nic nowszego — co jest prawdą, ale
nie znaczy „aktualne", i ckb-upgrade raportuje to jako „wyprzedza", a nie
jako bieżące. Cofnięcie takiej KB na main to downgrade: może usunąć skille
i obniżyć kb_schema_version poniżej tego, pod co napisano lokalne strony.
Wymaga wyraźnego potwierdzenia, a gdy schemat spadłby poniżej kontraktu
zadeklarowanego przez treść — jest blokowane.
Migracja między wersjami
Powiedz „upgrade the wiki" albo „check for a newer template version".
Aby użyć innego kanału, nazwij go: „upgrade from the test branch", „check
experimental", „switch back to stable".
Skill ckb-upgrade sprawdza kanoniczne repozytorium szablonu, aktualizuje
warstwę narzędziową w miejscu i — osobno, i wyłącznie po twoim wyraźnym
potwierdzeniu — migruje istniejącą treść wiki/ do bieżącego schematu,
zachowując każdy już zebrany fakt.
Te dwie połowy są celowo rozdzielone. Wzięcie nowszych skilli nigdy nie
przepisuje twoich stron, a migracja treści nigdy nie jest cicha: zgłasza, co
zamierza zmienić, zbiera wszystko, co musiała wywnioskować (na przykład
brakujące type), do twojego potwierdzenia i loguje każdą dotkniętą stronę w
wiki/log.md z adnotacją, że to uzupełnienie migracyjne schematu, a nie nowa
wiedza.
Szablon 1.10 przeniósł MANUAL*, CHANGELOG* i OPENSPEC* z katalogu
głównego do docs/. KB aktualizowana z 1.9 lub starszej ma je w katalogu
głównym; ckb-upgrade przenosi je i poprawia linki w README*. Nic pod
wiki/ nie jest dotknięte.
Ponieważ każda dotychczasowa wersja schematu była addytywna, starsze wiki działa bez migracji. Migrację warto zrobić po to, żeby nowsze kontrole miały sens — uzupełnione skróty źródeł dają lintowi cokolwiek do weryfikacji — a nie dlatego, że bez niej coś jest zepsute.
Wersja i licencja
Aktualna wersja szablonu: VERSION. Aktualna wersja schematu: pole
kb_schema_version w wiki/index.md. Licencja:
Apache License 2.0.