Katalog poleceń CLI

Zakres weryfikacji

Treść zachowana z obecnego źródła. Publikacja dokumentacji nie oznacza ponownego potwierdzenia wszystkich komend, przykładów i deklaracji możliwości.

Poziom: średniozaawansowany i ekspert. Początkujący powinien zacząć od pierwszego projektu.

CLI działa na katalogu projektu albo wskazanym pliku .jnx. Polecenia i opcje są po angielsku, ponieważ stanowią publiczny interfejs programu; ich znaczenie opisujemy tutaj po polsku.

Projekt i kompilacja

Polecenie	Zastosowanie
init	tworzy katalog projektu, manifest i minimalne źródło
doctor	sprawdza manifest, wejście, środowiska i układ projektu
parse	buduje strukturę składni bez analizy znaczenia
check	sprawdza składnię, semantykę i topologię bez generowania
analyze	zapisuje model analizy dla innych narzędzi
build	generuje artefakty wybranych środowisk
run	buduje i uruchamia serwer oraz wygenerowany panel w jednej ograniczonej sesji
clean	usuwa wygenerowany stan bez dotykania źródeł autora

flowchart LR
    INIT["init"] --> DOCTOR["doctor"]
    DOCTOR --> CHECK["check"]
    CHECK --> ANALYZE["analyze"]
    CHECK --> BUILD["build"]
    BUILD --> RUN["run"]
    BUILD --> CLEAN["clean"]
    CLEAN -.-> CHECK

junexis run [projekt] --duration N jest prowadzonym rytuałem lokalnego uruchomienia. Sam wykonuje build, uruchamia wygenerowany serwer Go, a gdy projekt ma @report, buduje aplikację WWW, dobiera rozłączne porty, czeka na gotowość obu procesów i otwiera panel w domyślnej przeglądarce. Opcja --no-open pozostawia panel uruchomiony, lecz tylko wypisuje jego adres. Domyślne osiem sekund i zakres 1–300 chronią początkującego przed pozostawieniem niekontrolowanych procesów. To nie zastępuje pakowania ani wdrożenia wielowęzłowego.

Integracja kodu autora

Polecenie	Zastosowanie
extern scaffold	tworzy brakujące pliki implementacji extern
report scaffold	tworzy deklaratywny widok albo nienadpisywany adapter DOM, React lub Vue
runtime primitives	pokazuje prymitywy wykonania i pokrycie środowisk
conformance	pokazuje poziom zgodności semantycznej i luki
lsp	uruchamia serwer językowy przez standardowe wejście i wyjście

extern scaffold nie powinno nadpisywać istniejących plików autora. Przed wykonaniem można użyć trybu podglądu opisanego przez --help.

W bieżącej wersji polecenie analizuje moduł wejściowy projektu. Nie przechodzi jeszcze po wszystkich importowanych modułach. Jeżeli extern storage znajduje się w osobnym module, utwórz jawnie plik wskazany przez pole file; build nadal waliduje kontrakt i kopiuje adapter do wyniku. Pełny rytm opisuje przewodnik pracy z modułami i bazą.

report scaffold również działa jednokierunkowo: tworzy starter tylko wtedy, gdy adapter jeszcze nie istnieje. --framework dom|react|vue wybiera wariant; DOM jest domyślny. React i Vue otrzymują dodatkowo kontrolowany user/report/package.json. Build kopiuje pliki autora do artefaktu, oznacza je jako user-overlay i scala wyłącznie zależności; źródła pozostają poza generowanym out/.

--declarative tworzy zamiast kodu plik user/report/view.json na podstawie zadań @report znalezionych w projekcie. Build waliduje konfigurację i kompiluje ją do typowanego widoku; nieopisane zadania oraz puste listy pól zachowują bezpieczny renderer automatyczny.

Weryfikacja artefaktów

Polecenie	Zastosowanie
validate-example	sprawdza przykład, generuje Go i wykonuje natywną kompilację
artifact-gate	sprawdza kontrakty artefaktów i dostępne zestawy narzędzi
package	sprawdza narzędzia, materializuje runtime, tworzy i weryfikuje paczkę

Paczka systemu

Polecenie	Zastosowanie
bundle create	tworzy paczkę z ostatniego poprawnego budowania
bundle verify	sprawdza integralność, autentyczność i politykę dopuszczenia
bundle sign	podpisuje manifest paczki zewnętrznym kluczem ECDSA P-256

flowchart LR
    BUILD["build"] --> CREATE["bundle create"]
    CREATE --> SIGN["bundle sign"]
    CREATE --> VERIFY["bundle verify"]
    SIGN --> VERIFY
    VERIFY --> DEPLOY["wdrożenie"]

Wdrożenie

Polecenie	Zastosowanie
deploy	przygotowuje opis wdrożenia projektu
deploy preflight	weryfikuje paczkę, gotowość środowisk i opinię Mentora
deploy local	uruchamia z paczki ograniczoną sesję server/report bez ponownego budowania
deploy local status	odczytuje stan lokalnej sesji
deploy local stop	kończy sesję z kontrolą jej właściciela
deploy local adopt	jawnie przejmuje osieroconą sesję
deploy embedded probe	wykrywa PlatformIO i urządzenia bez programowania pamięci
deploy embedded select	zapisuje jawnie wybrane urządzenie
deploy embedded flash	programuje wybrane urządzenie zweryfikowanym artefaktem

Operacje na urządzeniu są rozdzielone celowo: wykrycie nie programuje pamięci, a programowanie wymaga wcześniej zapisanego wyboru urządzenia.

Pomoc i format maszynowy

junexis --help
junexis deploy --help
junexis deploy embedded flash --help

Część poleceń udostępnia wynik JSON. Automatyzacje powinny używać jawnego formatu maszynowego, zamiast analizować tekst przeznaczony dla człowieka.

Zobacz podstawy CLI, manifest projektu, kontrakty wyniku budowania, diagnostykę i pakowanie.