# Cargo serializes shared builds; dependencies live outside every checkout. # Only the release executable is installed locally for runtime/sandbox use. export CARGO_TARGET_DIR := env_var_or_default("XDG_CACHE_HOME", home_directory() / ".cache") / "nuguland/cargo" default: @just --list # create an agent worktree outside the live desktop config; prints its directory worktree name: #!/usr/bin/env bash set -euo pipefail name={{ quote(name) }} [[ "$name" =~ ^[a-z0-9][a-z0-9-]*$ ]] || { echo "usage: just worktree " >&2; exit 2; } dir="${TMPDIR:-/tmp}/nuguland-$name" git worktree add --quiet -b "agent/$name" "$dir" HEAD # The nested sandbox runs vault-native/run.sh against the copy, not the shared cache. if [[ -x "$CARGO_TARGET_DIR/release/nuguland-vault" ]]; then install -D "$CARGO_TARGET_DIR/release/nuguland-vault" "$dir/quickshell/nuguland/vault-native/target/release/nuguland-vault" else echo "no release vault binary: run just build here first, or vault ui-test suites report unavailable-vault" >&2 fi echo "$dir/quickshell/nuguland" # owner only: restart the live desktop shell; agents never run it reload: #!/usr/bin/env bash set -euo pipefail mapfile -t pids < <(qs list -c nuguland -j | node -e 'const text = require("fs").readFileSync(0, "utf8").trim(); for (const instance of text ? JSON.parse(text) : []) console.log(instance.pid)') for pid in "${pids[@]}"; do qs kill --pid "$pid"; done # The new instance only gets the notification and tray bus names once the old one has exited. for pid in "${pids[@]}"; do for _ in $(seq 50); do kill -0 "$pid" 2>/dev/null || continue 2 sleep 0.1 done echo "nuguland $pid did not exit within 5 s" >&2 exit 1 done qs -c nuguland -d # check host packages; ~90ms when present, installs missing ones explicitly when interactive deps: #!/usr/bin/env bash set -euo pipefail packages=( weston niri quickshell pipewire wdotool wtype bubblewrap dbus systemd systemd-libs iproute2 gcc pkgconf wayland wayland-protocols libxkbcommon wl-clipboard imagemagick colord qt6-base qt6-declarative qt6-shadertools glslang shellcheck shfmt cargo nushell tar zstd util-linux coreutils pastel glib2 aerc tmux procps-ng wezterm neovim neovide ) command -v node >/dev/null || { echo "missing node: install it through mise" >&2; exit 1; } if missing=$(pacman -T "${packages[@]}"); then exit 0; else status=$?; fi ((status == 127)) || exit "$status" mapfile -t missing <<<"$missing" if [[ -t 0 ]]; then sudo pacman -S --needed "${missing[@]}" else echo "missing packages; run: sudo pacman -S --needed ${missing[*]}" >&2 exit 1 fi # lint/typecheck/verify all Nuguland source; zero warnings lint: deps #!/usr/bin/env bash set -euo pipefail tmp=$(mktemp -d) qs_pid="" cleanup() { [[ -z "$qs_pid" ]] || kill "$qs_pid" 2>/dev/null || true rm -rf "$tmp" } trap cleanup EXIT mapfile -t qml < <(find . -path ./vault-native -prune -o -name '*.qml' -print | sort) mapfile -t sh < <(find . -path './vault-native/target' -prune -o -name '*.sh' -print | sort) mapfile -t mjs < <(find . -name '*.mjs' -print | sort) mapfile -t frag < <(find shaders -name '*.frag' -print 2>/dev/null | sort) # One qmllint process: same per-file diagnostics and exit status, about 5x faster. /usr/lib/qt6/bin/qmllint --max-warnings 0 -I /usr/lib/qt6/qml "${qml[@]}" || { echo "qmllint failed" >&2; exit 1; } ((${#sh[@]} == 0)) || shellcheck "${sh[@]}" for file in "${mjs[@]}"; do node --check "$file" done cc -std=c17 -Wall -Wextra -Werror -fsyntax-only $(pkg-config --cflags colorhug) ambient-light-native/read.c cargo fmt --manifest-path vault-native/Cargo.toml --check cargo clippy --manifest-path vault-native/Cargo.toml --all-targets --locked -- -D warnings cargo test --manifest-path vault-native/Cargo.toml --locked cargo build --manifest-path vault-native/Cargo.toml --locked just test just load-test ((${#frag[@]} == 0)) || glslangValidator "${frag[@]}" for file in "${qml[@]}"; do out="$tmp/${file#./}" mkdir -p "$(dirname "$out")" /usr/lib/qt6/bin/qmlformat "$file" > "$out" || { echo "qmlformat failed: $file" >&2; exit 1; } cmp -s "$file" "$out" || { echo "qmlformat changed: $file" >&2; diff -u "$file" "$out"; exit 1; } done for file in "${sh[@]}"; do out="$tmp/${file#./}" mkdir -p "$(dirname "$out")" shfmt "$file" > "$out" cmp -s "$file" "$out" || { diff -u "$file" "$out"; exit 1; } done shopt -s nullglob for shader in shaders/*.frag; do out="$tmp/${shader//\//__}.qsb" /usr/lib/qt6/bin/qsb --glsl 330 --hlsl 50 --msl 12 -o "$out" "$shader" cmp -s "$shader.qsb" "$out" || { echo "stale shader blob: $shader.qsb" >&2; exit 1; } done for blob in shaders/*.qsb; do [[ -f "${blob%.qsb}" ]] || { echo "orphan shader blob: $blob" >&2; exit 1; } done # run JS tests; pass a file, basename, stem, or vault-native for all Rust tests # examples: just test, just test network, just test vault-native test name="": deps #!/usr/bin/env bash set -euo pipefail target={{quote(name)}} if [[ "$target" == vault-native ]]; then exec cargo test --manifest-path vault-native/Cargo.toml --locked fi if [[ -n "$target" ]]; then case "$target" in /*|*..*|*$'\n'*|*$'\r'*) echo "unsafe test: $target" >&2; exit 2 ;; esac names=("$target") [[ "$target" == *.js || "$target" == *.mjs ]] || names=("$target.test.js" "$target.test.mjs") # A path runs as given; a bare stem searches root and feature directories alike, # so a duplicate name anywhere is reported as ambiguous instead of shadowed. found=() for name in "${names[@]}"; do if [[ "$name" == */* ]]; then [[ ! -f "$name" ]] || found+=("$name") else mapfile -t -O "${#found[@]}" found < <(find . -path ./vault-native -prune -o -type f -name "$name" -print) fi done ((${#found[@]} == 1)) || { echo "missing or ambiguous test: $target ${found[*]}" >&2; exit 2; } node "${found[0]}" exit fi mapfile -t tests < <(find . -path ./vault-native -prune -o \( -name '*.test.js' -o -name '*.test.mjs' \) -print | sort) ((${#tests[@]} > 0)) || { echo "no tests" >&2; exit 1; } node --test --test-concurrency=4 "${tests[@]}" # run one JS test many times concurrently; any failure means it is flaky # examples: just stress ambient-light, just stress ui-test 32 stress test runs="16": deps node stress-test.mjs {{quote(test)}} {{quote(runs)}} # load a feature's panel offscreen with its fixture doubles; any warning fails # examples: just load-test, just load-test audio load-test feature="all": deps node load-test.mjs {{quote(feature)}} # run nested-niri UI suites; retain screenshots and logs ui-test fixture="all" size="": deps node ui-test.mjs {{quote(fixture)}} {{if size == "" { "" } else { quote(size) }}} # format Nuguland QML and shell scripts in place fmt: deps #!/usr/bin/env bash set -euo pipefail mapfile -t qml < <(find . -path ./vault-native -prune -o -name '*.qml' -print | sort) mapfile -t sh < <(find . -path './vault-native/target' -prune -o -name '*.sh' -print | sort) for file in "${qml[@]}"; do /usr/lib/qt6/bin/qmlformat -i "$file" || { echo "qmlformat failed: $file" >&2; exit 1; } done ((${#sh[@]} == 0)) || shfmt -w "${sh[@]}" cargo fmt --manifest-path vault-native/Cargo.toml # build native helpers and compile checked-in shaders build: deps #!/usr/bin/env bash set -euo pipefail cc -std=c17 -Wall -Wextra -Werror -O2 $(pkg-config --cflags colorhug) ambient-light-native/read.c -o ambient-light-native/read $(pkg-config --libs colorhug) cargo build --manifest-path vault-native/Cargo.toml --release --locked install -D "$CARGO_TARGET_DIR/release/nuguland-vault" vault-native/target/release/nuguland-vault shopt -s nullglob for shader in shaders/*.frag; do /usr/lib/qt6/bin/qsb --glsl 330 --hlsl 50 --msl 12 -o "$shader.qsb" "$shader" done