Architektura projektu

BUILD_INSTRUCTIONS — KretNotes

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 — KretNotes

03 — KretNotes

Cel

Notatnik na KretDB: tworzenie, odczyt, edycja z kontrolą rewizji, usuwanie, wyszukiwanie, sortowanie; izolowana baza pluginu (4 MB, limit 1000 rekordów). Interfejs KretUI z KretStyle/KTheme. Dane wyłącznie przez nazwane zapytania i transakcje — plugin nie widzi SQL.

Struktura

Szybki start

1kret check src --json
2kret run src --policy examples/host-policy.json --data <nowy katalog> --invoke 'notes.save=["","0","Pierwsza notatka","Treść","test"]' --invoke 'notes.list=["","",""]'

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

SECURITY_PERMISSIONS — KretNotes

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

1permissions { required { kretdb.open
2 kretdb.read
3 kretdb.write }
4 optional {  } }
5 lifecycle { start "Main.Start" timeout 5s
6 shutdown "Main.Shutdown" timeout 3s }
7 execution { primary "onDemand" }
8 handlers { command "notes.list"
9 command "notes.open"
10 command "notes.new"
11 command "notes.save"
12 command "notes.autosave"
13 command "notes.delete" }
14}

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 (kretdb.* w Core)**. 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.

KretNotes — 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["KretS"]
  L2["KretDB"]
  L3["KretUI"]
  L4["KretStyle"]
  L5["KTheme"]
  Manifest["src/plugin.kretl"] --> Broker
  UI["kretui-host (renderer, osobny proces)"] -->|komendy| Broker
  Broker --> DB[("KretDB: baza pluginu należy do brokera")]

Pochodzenie / provenance: Kopia engine/Plugins/KretNotes/Source + polityka fixture TestFixtures/isolated-sdk-policy.json. / Copy of the Core plugin source and its SDK fixture policy.

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["KretS"]
  L2["KretDB"]
  L3["KretUI"]
  L4["KretStyle"]
  L5["KTheme"]
  Manifest["src/plugin.kretl"] --> Broker
  UI["kretui-host (renderer, osobny proces)"] -->|komendy| Broker
  Broker --> DB[("KretDB: baza pluginu należy do brokera")]

Pochodzenie / provenance

Kopia engine/Plugins/KretNotes/Source + polityka fixture TestFixtures/isolated-sdk-policy.json. / Copy of the Core plugin source and its SDK fixture policy.

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

KretNotes — 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.

Notatnik na KretDB: tworzenie, odczyt, edycja z kontrolą rewizji, usuwanie, wyszukiwanie, sortowanie; izolowana baza pluginu (4 MB, limit 1000 rekordów). Interfejs KretUI z KretStyle/KTheme. Dane wyłącznie przez nazwane zapytania i transakcje — plugin nie widzi SQL.