KretConfig — wprowadzenie

KretConfig — wprowadzenie

Status 1.0: `PROVISIONAL_VERSIONED` — zdefiniowane i przetestowane, za mało dowodów na stabilne 1.0; własna ścieżka rozwoju. Gramatyka/wersja: kconfig-1.0. Status języka nie nadaje uprawnień KCS ani prawa do działania w Production.

Czym jest

KretConfig opisuje ustawienia pluginu: schemat (typy z jednostkami, zakresy, wartości dozwolone, hotReload, ustawienia tajne), profile (z dziedziczeniem), warstwy (domyślne → użytkownik → projekt → moduł) i politykę hosta, która zawsze wygrywa. Sekrety wyłącznie przez Vault (Windows DPAPI). Status PROVISIONAL_VERSIONED (własna ścieżka rozwoju).

Dla początkujących

Definiujesz ustawienia (np. „co ile odświeżać”, „tryb”) z typem i wartością domyślną, potem profile z innymi wartościami. Plugin czyta gotową, sprawdzoną konfigurację; hasła i klucze nie trafiają do plików.

Dla zaawansowanych programistów

Każda wartość ma pochodzenie (default, user:p, project:p, module:p, policy). Hot reload dwufazowy: błąd walidacji albo wyjątek odbiorcy wycofuje całą zmianę; ustawienie bez hotReload true → KCS-CFG-0205 (wymaga restartu). Blok policy poza plikiem polityki hosta → KCS-CFG-0203. KretS (getString/getInt/getFloat/getBool) nie odczyta sekretu (sprawdzone: odmowa KCS-CFG-0007). Vault na Linux/macOS → KCS-CFG-0207 (nie udaje ochrony).

Jakie problemy rozwiązuje

Typowana, warstwowa konfiguracja z nadrzędną polityką hosta i bez sekretów w plikach.

Kiedy używać

• ustawienia pluginu i profile (np. gaming, quiet)
• ograniczenia hosta (blokady, minimum/maksimum)
• klucze API przez Vault (dla hosta, np. brama modeli)

Kiedy nie używać

• sekrety wpisane wprost (KCS-CFG-0007)
• ustawienia typu lista/rekord (NOT_SUPPORTED)
• Vault poza Windows
• traktowanie jako FROZEN — status PROVISIONAL

Współpraca z innymi technologiami

KretS (use Kret.Config as config), KretAI (sekret klucza modelu), Core (warstwa Store ✓, Vault ✗).

Obecny status

PROVISIONAL_VERSIONED — zdefiniowane i przetestowane, za mało dowodów na stabilne 1.0; własna ścieżka rozwoju.

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