Layer 2 - Dev Pipeline#

Layer 1 pozwala AI sterować urządzeniami. Layer 2 pozwala AI pisać i wdrażać kod - moduły Lua, automatyzacje, integracje z pluginami.

Architektura#

graph LR
    subgraph Klienci
        cc["Claude Code"]
        cx["Codex CLI"]
        gm["Gemini CLI"]
    end

    subgraph vCLU
        l1["Layer 1<br/>6 tools<br/>sterowanie"]
        l2["Layer 2<br/>17 tools<br/>dev mode"]
        workspace["Workspace<br/>(drafts)"]
        sandbox["Sandbox<br/>(izolacja)"]
        promote["Promote<br/>(produkcja)"]
        l2 --> workspace --> sandbox --> promote
    end

    cc <-->|"MCP (HTTP/SSE)<br/>Bearer token"| l1
    cc <-->|"MCP"| l2

Wymagania#

Layer 2 wymaga włączenia Dev Mode:

W dashboardzie MCP (/mcp) zaznacz checkbox “Dev Mode”
W konfiguracji bota zaznacz “Sandbox” - bot bez tego widzi tylko Layer 1

Trzy kategorie narzędzi#

1. Eksploracja (6 narzędzi)#

Pozwalają AI przeczytać kod źródłowy, przeszukać pliki, sprawdzić logi i zbadać pełny rejestr urządzeń.

Narzędzie	Opis
`vclu_read_file`	Odczyt pliku Lua, dokumentacji lub konfiguracji
`vclu_list_files`	Lista plików pasujących do wzorca glob
`vclu_grep`	Przeszukiwanie kodu regexem
`vclu_logs`	Ostatnie logi runtime z filtrem
`vclu_config`	Konfiguracja systemu (bez sekretów)
`vclu_registry`	Pełny rejestr urządzeń z metadanymi (area, group, tags)

Szczegóły: Narzędzia dev

2. Sandbox Pipeline (9 narzędzi)#

Pipeline do bezpiecznego pisania kodu: draft > validate > test > promote.

Narzędzie	Opis
`vclu_draft_write`	Zapisz plik Lua do workspace (drafts)
`vclu_draft_read`	Odczytaj draft
`vclu_draft_list`	Lista wszystkich draftów
`vclu_draft_delete`	Usuń draft
`vclu_draft_validate`	Walidacja składni Lua + blocklist
`vclu_draft_test`	Test w izolowanym sandboxie (bez efektów ubocznych)
`vclu_draft_promote`	Wdrożenie do produkcji (backup + zamiana + reload)
`vclu_diff`	Diff draftu vs plik produkcyjny
`vclu_audit_log`	Historia operacji Layer 2

Szczegóły: Sandbox i promocja

3. Pamięć agenta (2 narzędzia)#

Trwały kontekst między sesjami - agent zapisuje obserwacje, TODOs i odkryte ograniczenia.

Narzędzie	Opis
`vclu_context_save`	Dopisz notatki do pamięci agenta
`vclu_context_read`	Odczytaj notatki z poprzednich sesji

Przykład: AI pisze automatyzację#

Ty:    "Napisz skrypt, żeby światło w biurze włączało się codziennie o 17:00"

AI:    → vclu_registry(filter: {area: "Biuro"})
         - znalazł 3 lampy w biurze
       → vclu_read_file("modules/init.lua")
         - sprawdził istniejące moduły
       → vclu_draft_write("modules/biuro_auto.lua", "...")
         - napisał moduł Lua
       → vclu_draft_validate("modules/biuro_auto.lua")
         - brak błędów składni
       → vclu_draft_test("modules/biuro_auto.lua")
         - sandbox: 0 errors, 0 blocked calls
       → vclu_draft_promote("modules/biuro_auto.lua")
         - wdrożone + Lua reload
       ✓ Gotowe - biuro będzie się zapalać o 17:00.

Porównanie Layer 1 i Layer 2#

	Layer 1	Layer 2
Cel	Sterowanie urządzeniami	Pisanie kodu i automatyzacji
Narzędzia	6 + 2 zasoby	17 dodatkowych
Dev Mode	Nie wymagany	Wymagany
Modyfikuje pliki	Nie	Tak (moduły Lua)
Sandbox	-	Izolowany silnik Lua
Audit trail	Activity log	Persystowany audit log (JSONL)
Rate limits	-	30 sandbox/min, 10 promote/godz

Edytor webowy#

Oprócz MCP, drafty można zarządzać przez wbudowany Edytor Lua - przeglądarka draftów, widok diff, promote jednym kliknięciem i pełna historia operacji z timeline.

Następny krok#

Narzędzia dev - eksploracja kodu i rejestru urządzeń