KretMultiLanguage

BUILD_INSTRUCTIONS — KretMultiLanguage

Katalog roboczy / working directory: folder tego pluginu (zawiera src/). kret = <SDK>\Compiler\kret.exe z SDK 1.0.0-rc.3+kret.local.3 (lub pinned Vendor Core rc.3+kc-base-test610). Wszystkie polecenia poniżej zostały wykonane w tej rundzie — wyniki: TEST_RESULTS.json.

Uwagi / notes:

• --include-sources jest wymagane dla KPM Core: Core kompiluje plugin ze źródeł i odrzuca paczkę z samym bytecode (source_package_required, STUDIO-R02). / Required for Core KPM.
• Kanał dev: paczka niepodpisana (signature: SKIPPED, nie PASS). Brak podpisu produkcyjnego — ceremonia C1 nie odbyła się. / Unsigned dev package; no production signature exists.
• host-policy.json nigdy nie trafia do .kpkg (lista dozwolonych KretPublish). / Never packed.

COMPATIBILITY — KretMultiLanguage

07 — KretMultiLanguage

Cel

Jeden projekt łączący oficjalnie obsługiwane technologie: manifest KretL z mapą KretM (warstwy Ui → Logic → Data), moduły KretS z regułami mapy, dane KretDB, biblioteka offline KretLib (mathx → textutil) i widok KretUI wywołujący komendę orders.summary.

Struktura

Szybki start

1kret check src --json
2kret run src --policy examples/host-policy.json --data <nowy katalog> --invoke orders.summary

Status języka nie nadaje uprawnień KCS ani prawa do Production.

SECURITY_PERMISSIONS — KretMultiLanguage

Zadeklarowane uprawnienia / declared permissions (src/plugin.kretl)

1permissions {
2        required {
3            logs.own.write
4            kretdb.open
5            kretdb.read
6            kretdb.write
7        }
8    }

Zasady / rules

• Deklaracja ≠ przyznanie (KCS-PERM-3). Dostęp daje polityka hosta i KCS przy każdym wywołaniu (Security Broker). / Declaration is not a grant.
• examples/host-policy.json to polityka hosta testowego SDK (allowProvisionalRisk tylko dla testów). Nigdy nie importuj jej do Core ani do danych użytkownika. / Test-host policy only; never import into Core.
• Logika działa w osobnym procesie pluginu (Job Object, token ograniczony / AppContainer). Interfejs KretUI nie nadaje uprawnień i nie przechowuje sekretów. / Logic runs in a separate restricted process.
• Status w Core / Core status: **BLOCKED_KCS_D_KCS_01 (logs.own.write, kretdb.*)**. D-KCS-01 pozostaje OPEN; uprawnienia PROVISIONAL nie są aktywowane w Production. / Not activated in Production.
• Paczka: kanał dev, niepodpisana, z źródłami; nie zawiera kluczy, haseł ani polityki hosta (kontrola sekretów KretPublish). / Dev channel, unsigned, no keys or secrets.

Znane ograniczenie / known limitation (EXP-F02)

kretui-host --self-test (SDK 1.0.0-rc.3+kret.local.3) kompiluje projekt bez bibliotek KretLib z Libs/ i zgłasza KCS-KRS-1003: nieznana nazwa MathX. kret check/build/run/pack dołączają biblioteki poprawnie. Podgląd Ui/Summary.kretui dla projektu z KretLib jest więc NOT_RUN do poprawki SDK. / kretui-host compiles without KretLib libraries; UI preview of KretLib projects is NOT_RUN until an SDK fix.

KretMultiLanguage — architektura / architecture

flowchart LR
  Host["Host: kret run / KretStudio / Kret Engine"] --> Broker["Security Broker (KCS przy każdym wywołaniu)"]
  Broker --> Proc["Proces pluginu (Job Object, AppContainer)"]
  Proc --> VM["Maszyna KBC 2 + weryfikator"]
  L0["KretL"]
  L1["KretM"]
  L2["KretS"]
  L3["KretDB"]
  L4["KretLib"]
  L5["KretUI"]
  Manifest["src/plugin.kretl"] --> Broker
  UI["kretui-host (renderer, osobny proces)"] -->|komendy| Broker
  Broker --> DB[("KretDB: baza pluginu należy do brokera")]

Pochodzenie / provenance: Szablony SDK core-plugin (KretL+KretM+KretS+KretDB) i library (KretLib) połączone w eksporcie + widok KretUI. / SDK templates core-plugin and library combined + a KretUI view.

Architecture diagram

flowchart LR
  Host["Host: kret run / KretStudio / Kret Engine"] --> Broker["Security Broker (KCS przy każdym wywołaniu)"]
  Broker --> Proc["Proces pluginu (Job Object, AppContainer)"]
  Proc --> VM["Maszyna KBC 2 + weryfikator"]
  L0["KretL"]
  L1["KretM"]
  L2["KretS"]
  L3["KretDB"]
  L4["KretLib"]
  L5["KretUI"]
  Manifest["src/plugin.kretl"] --> Broker
  UI["kretui-host (renderer, osobny proces)"] -->|komendy| Broker
  Broker --> DB[("KretDB: baza pluginu należy do brokera")]

Pochodzenie / provenance

Szablony SDK core-plugin (KretL+KretM+KretS+KretDB) i library (KretLib) połączone w eksporcie + widok KretUI. / SDK templates core-plugin and library combined + a KretUI view.

Dokumentacja wygenerowana przez eksport KretLanguageDocumentation (2026-11-01). Wszystkie polecenia z BUILD_INSTRUCTIONS.md zostały wykonane; wyniki w TEST_RESULTS.json.

KretMultiLanguage — karta przykładowego pluginu

Status RUNNABLE_LOCAL oznacza uruchomienie lokalne przez SDK — to nie jest PRODUCTION_READY. Paczka .kpkg nie jest dostępna do publicznego pobrania.

Jeden projekt łączący oficjalnie obsługiwane technologie: manifest KretL z mapą KretM (warstwy Ui → Logic → Data), moduły KretS z regułami mapy, dane KretDB, biblioteka offline KretLib (mathx → textutil) i widok KretUI wywołujący komendę orders.summary.