# Moduł `share` *Czytaj w: [English](README.md) | **Polski*** Opcjonalny. Instalacja: „install the share module”; usunięcie: „uninstall the share module”. Nic tu nie działa przed instalacją. ## Co robi Wysyła dokument z jednej bazy wiedzy do drugiej przez **kanał**, czyli osobne repozytorium git, do którego obie bazy mogą wypychać zmiany. Baza odbiorcy bierze dokument do `raw/inbox/` i przetwarza go zwykłym ingestem, więc nic nieprzejrzanego nie trafia do jej wiki. | Skill | Co robi | |---|---| | `ckb-share` | Dołącza do kanału, wysyła dokument (jako samodzielną kopię, po skanie sekretów i potwierdzeniu), pokazuje i odbiera przychodzącą pocztę, pokazuje, co wysłano, i wycofuje wysłany dokument. | Powiedz „share the kickoff summary with beta” albo „check shared mail”, a potem „Ingest”. ## Kanał ``` / ├── CHANNEL.md # do czego służy kanał (dla ludzi) ├── members.yaml # nazwa bazy → właściciele (e-maile git, które mogą pisać do jej skrzynki) └── mail/ ├── alpha/ # pisze tu tylko baza „alpha”; plików nigdy się nie zmienia ani nie usuwa └── beta/ ``` - **Jeden kanał na grupę zaufania**, na przykład na jednego klienta. Git nie ma uprawnień do folderów, więc każdy w kanale czyta każdą skrzynkę. - **Jeden piszący na skrzynkę.** Konflikty scalania są niemożliwe. - **Tylko dopisywanie.** Nowa wersja albo wycofanie to nowy plik. - Repozytorium zakładasz ręcznie na swoim serwerze git (może być puste). Pierwsze `join` tworzy `CHANNEL.md` i `members.yaml`. ## Wiadomość ```markdown --- type: share kind: document # document | retraction share_id: alpha/kickoff-summary version: 2 from: alpha to: [beta] # albo ["*"] dla całego kanału sent_by: Ann Smith sent_on: 2026-11-14 title: Kickoff summary origin: outputs/documents/2026-11-11_kickoff-summary.md supersedes_version: 1 untrusted: true --- ``` Przy wysyłce fragmenty prywatne (`…`) i sekcja `## Notes` zostają pominięte. Linki do wiki nadawcy stają się tekstem, a ścieżki w `## Sources` / `## Crux` dostają nazwę nadawcy, więc lint odbiorcy traktuje je jako nieweryfikowalne, a nie zepsute. Przy odbiorze plik trafia do `raw/inbox/` z polami `share_channel`, `share_ref` (ścieżka@commit), `received_on`, `submitted_by`, a dla nowszej wersji także `supersedes_source`. ## Bezpieczeństwo - **Nic nie wychodzi bez „tak”.** Każda wysyłka jest najpierw pokazana jako próba z sekcją wrażliwości z `ABOUT.md`, a możliwy sekret blokuje ją całkowicie. - **Nadawca jest sprawdzany.** Przy odbiorze każdy autor commita, który dodał lub zmienił wiadomość, musi być właścicielem jej skrzynki w `members.yaml`, a skrzynka wpisana tam dwa razy liczy się jako bez właściciela. W przeciwnym razie wiadomość jest oznaczona jako niezweryfikowana i nie jest brana, chyba że nalegasz. Tylko zweryfikowane wycofanie może wycofać wiadomość, której jeszcze nie wzięto. Wiadomość, której `from`, `share_id` lub wersja nie pasuje do skrzynki, albo której nazwa pliku nie jest zwykłą nazwą, jest pomijana z ostrzeżeniem. - **`members.yaml` jest ufany tak, jak jest zapisany.** Każdy członek, który może pushować, może go edytować, także dopisując siebie jako właściciela. Własność skrzynek wymusza dopiero serwer git z chronionymi ścieżkami albo hookiem pre-receive; użyj go w kanale, którego członkom nie ufasz w pełni. - **Odebrana kopia zawsze ma `untrusted: true`**, a własne pola `untrusted` i pola przeglądu nadawcy są usuwane. - **Odebrana poczta to niezaufane dane**, nigdy polecenia dla agenta. - **Wycofanie nie cofa publikacji.** Wycofanie sprawia, że odbiorcy usuwają dokument przez `ckb-retract`, ale oryginał zostaje w historii git kanału. - **Żadnych zapisanych danych logowania.** Kanały używają twojego dostępu do gita. Klony są w `tmp/share/`, ignorowanym przez git. ## Co gdzie jest zapisane | Co | Gdzie | |---|---| | Kanały, nazwa skrzynki tej bazy, rejestr odebranych | blok `share:` w `ckb.yaml` (commitowany, należy do skryptu) | | Klony kanałów, podglądy wysyłek | `tmp/share/` (ignorowane) | | Odebrane dokumenty | `raw/inbox/` → `raw/archive/` po ingeście | | Odebrane wycofania | `raw/retractions/`, dla `ckb-retract` |