KretLink — wprowadzenie

KretLink — wprowadzenie

Status 1.0: `FROZEN_SUPPORTED_SUBSET` — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0. Gramatyka/wersja: klink-1.0. Status języka nie nadaje uprawnień KCS ani prawa do działania w Production.

Czym jest

KretLink to wersjonowane kontrakty usług (.klink) i dwa protokoły: łącze broker↔plugin kretlink-local/1 (stdin/stdout) oraz RPC kretlink-rpc/1 na potokach nazwanych (tożsamość procesu, wzajemny HMAC, terminy). Kontrakt można walidować, ale nie daje on prawa do komunikacji. Eksport usług pluginów, stream w Core i produkcyjne uprawnienia kretlink.* są zablokowane (A17, FB-06).

Dla początkujących

Kontrakt mówi, jakie metody ma usługa, jakie przyjmują parametry i co zwracają. SDK sprawdza kontrakt i generuje z niego JSON Schema. To jak umowa interfejsu — sama nie łączy programów.

Dla zaawansowanych programistów

Postać kanoniczna JSON + SHA-256 niezależny od kolejności metod. Dopuszczenie połączenia: tożsamość procesu z systemu (PID, ścieżka, opcjonalnie SHA-256) → wersja protokołu → wzajemny HMAC-SHA256 (usługa dowodzi pierwsza) → zgodność kontraktów. Każde wywołanie: metoda → uprawnienia → typy → limit równoległości → termin. Ramki ≤ 524 288 B (limit dokumentu KCS); identyfikator korelacji D-KCS-10; powtórzone/cofnięte identyfikatory wywołań zamykają połączenie. Strumienie z kredytem — EXPERIMENTAL (KCS-LNK-0121).

Jakie problemy rozwiązuje

Jawne, wersjonowane kontrakty komunikacji i bezpieczne lokalne IPC bez zaufania do samej możliwości połączenia z potokiem.

Kiedy używać

• kontrakty komunikacyjne i wersjonowane API
• kontrakty KretBridge (KretS ↔ C#)
• JSON Schema dla narzędzi

Kiedy nie używać

• eksport usług pluginów (zablokowany)
• RPC między komputerami (NOT_SUPPORTED)
• rekordy w kontraktach (NOT_SUPPORTED)
• Linux/macOS (tożsamość procesu niedostępna — NOT_SUPPORTED)

Współpraca z innymi technologiami

KretBridge (kontrakt usługi C#), KretS (kompilator sprawdza wywołania), broker (łącze kretlink-local/1), Core (RPC health, ramUsage).

Obecny status

FROZEN_SUPPORTED_SUBSET — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0.

Dalej: ARCHITECTURE.md · SYNTAX_REFERENCE.md · ../Tutorials/BASIC/TUTORIAL_PL.md