justfile

# A3S GUI - Justfile

default:
    @just --list

native-backend := if os() == "macos" {
    "appkit"
} else if os() == "linux" {
    "gtk4"
} else if os() == "windows" {
    "winui"
} else {
    error("unsupported operating system for native GUI examples")
}

# ============================================================================
# Build
# ============================================================================

# Build the default headless crate
build:
    cargo build --locked

# Build release artifacts for the default headless crate
release:
    cargo build --locked --release

# Build the native dogfood release artifact for this operating system
release-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo build --locked --release --features appkit-native --example appkit_dogfood
            ;;
        Linux)
            cargo build --locked --release --features gtk4-native --example gtk4_dogfood
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo build --locked --release --target x86_64-pc-windows-msvc --features winui-native --example winui_dogfood
            ;;
        *)
            echo "unsupported operating system for native GUI release builds: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Stage a native dogfood bundle for this operating system
bundle-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            just bundle-appkit
            ;;
        Linux)
            just bundle-gtk4
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            just bundle-winui
            ;;
        *)
            echo "unsupported operating system for native GUI bundles: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Build, stage, and validate the native dogfood bundle for this operating system
bundle-gate-native: bundle-native check-bundle-native

# Validate the staged native dogfood bundle for this operating system
check-bundle-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            just check-bundle-appkit
            ;;
        Linux)
            just check-bundle-gtk4
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            just check-bundle-winui
            ;;
        *)
            echo "unsupported operating system for native GUI bundle validation: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Stage the macOS AppKit dogfood app bundle
bundle-appkit:
    #!/usr/bin/env bash
    set -euo pipefail

    if [[ "$(uname -s)" != "Darwin" ]]; then
        echo "bundle-appkit must run on macOS" >&2
        exit 1
    fi

    cargo build --locked --release --features appkit-native --example appkit_dogfood

    bundle_dir="target/release/bundle/A3SGuiDogfood.app"
    rm -rf "$bundle_dir"
    mkdir -p "$bundle_dir/Contents/MacOS" "$bundle_dir/Contents/Resources"
    cp target/release/examples/appkit_dogfood "$bundle_dir/Contents/MacOS/A3SGuiDogfood"
    cp packaging/macos/A3SGuiDogfood-Info.plist "$bundle_dir/Contents/Info.plist"
    cp packaging/a3s-gui-dogfood-README.txt "$bundle_dir/Contents/Resources/README.txt"
    printf 'APPL????' > "$bundle_dir/Contents/PkgInfo"
    chmod +x "$bundle_dir/Contents/MacOS/A3SGuiDogfood"
    packaging/write-bundle-manifest.sh "$bundle_dir" "$bundle_dir/Contents/Resources/MANIFEST.txt" "macos-appkit" "a3s-gui-dogfood-macos"

    echo "staged $bundle_dir"

# Validate the staged macOS AppKit dogfood app bundle
check-bundle-appkit:
    #!/usr/bin/env bash
    set -euo pipefail

    if [[ "$(uname -s)" != "Darwin" ]]; then
        echo "check-bundle-appkit must run on macOS" >&2
        exit 1
    fi

    bundle_dir="target/release/bundle/A3SGuiDogfood.app"
    binary="$bundle_dir/Contents/MacOS/A3SGuiDogfood"
    plist="$bundle_dir/Contents/Info.plist"
    pkginfo="$bundle_dir/Contents/PkgInfo"
    readme="$bundle_dir/Contents/Resources/README.txt"
    manifest="$bundle_dir/Contents/Resources/MANIFEST.txt"

    [[ -d "$bundle_dir/Contents/MacOS" ]] || { echo "missing app MacOS directory: $bundle_dir/Contents/MacOS" >&2; exit 1; }
    [[ -d "$bundle_dir/Contents/Resources" ]] || { echo "missing app Resources directory: $bundle_dir/Contents/Resources" >&2; exit 1; }
    [[ -x "$binary" ]] || { echo "missing executable app binary: $binary" >&2; exit 1; }
    [[ -f "$plist" ]] || { echo "missing app Info.plist: $plist" >&2; exit 1; }
    [[ -f "$pkginfo" ]] || { echo "missing app PkgInfo: $pkginfo" >&2; exit 1; }
    [[ -f "$readme" ]] || { echo "missing app handoff README: $readme" >&2; exit 1; }
    [[ -f "$manifest" ]] || { echo "missing app bundle manifest: $manifest" >&2; exit 1; }
    [[ "$(/usr/libexec/PlistBuddy -c 'Print :CFBundleExecutable' "$plist")" == "A3SGuiDogfood" ]] || { echo "Info.plist CFBundleExecutable does not match A3SGuiDogfood" >&2; exit 1; }
    [[ "$(/usr/libexec/PlistBuddy -c 'Print :CFBundlePackageType' "$plist")" == "APPL" ]] || { echo "Info.plist CFBundlePackageType does not match APPL" >&2; exit 1; }
    [[ "$(cat "$pkginfo")" == "APPL????" ]] || { echo "PkgInfo does not match APPL????" >&2; exit 1; }
    grep -q 'unsigned smoke artifact' "$readme" || { echo "handoff README does not identify an unsigned smoke artifact" >&2; exit 1; }
    packaging/check-bundle-manifest.sh "$bundle_dir" "$manifest" "macos-appkit" "a3s-gui-dogfood-macos"

    echo "validated $bundle_dir"

# Stage the Linux GTK4 dogfood filesystem bundle
bundle-gtk4:
    #!/usr/bin/env bash
    set -euo pipefail

    if [[ "$(uname -s)" != "Linux" ]]; then
        echo "bundle-gtk4 must run on Linux" >&2
        exit 1
    fi

    cargo build --locked --release --features gtk4-native --example gtk4_dogfood

    bundle_dir="target/release/bundle/a3s-gui-dogfood-linux"
    rm -rf "$bundle_dir"
    mkdir -p "$bundle_dir/usr/bin" "$bundle_dir/usr/share/applications"
    cp target/release/examples/gtk4_dogfood "$bundle_dir/usr/bin/a3s-gui-dogfood"
    cp packaging/linux/a3s-gui-dogfood.desktop "$bundle_dir/usr/share/applications/a3s-gui-dogfood.desktop"
    cp packaging/a3s-gui-dogfood-README.txt "$bundle_dir/README.txt"
    chmod +x "$bundle_dir/usr/bin/a3s-gui-dogfood"
    packaging/write-bundle-manifest.sh "$bundle_dir" "$bundle_dir/MANIFEST.txt" "linux-gtk4" "a3s-gui-dogfood-linux"

    echo "staged $bundle_dir"

# Validate the staged Linux GTK4 dogfood filesystem bundle
check-bundle-gtk4:
    #!/usr/bin/env bash
    set -euo pipefail

    if [[ "$(uname -s)" != "Linux" ]]; then
        echo "check-bundle-gtk4 must run on Linux" >&2
        exit 1
    fi

    bundle_dir="target/release/bundle/a3s-gui-dogfood-linux"
    binary="$bundle_dir/usr/bin/a3s-gui-dogfood"
    desktop="$bundle_dir/usr/share/applications/a3s-gui-dogfood.desktop"
    readme="$bundle_dir/README.txt"
    manifest="$bundle_dir/MANIFEST.txt"

    [[ -x "$binary" ]] || { echo "missing executable GTK4 dogfood binary: $binary" >&2; exit 1; }
    [[ -f "$desktop" ]] || { echo "missing desktop entry: $desktop" >&2; exit 1; }
    [[ -f "$readme" ]] || { echo "missing GTK4 handoff README: $readme" >&2; exit 1; }
    [[ -f "$manifest" ]] || { echo "missing GTK4 bundle manifest: $manifest" >&2; exit 1; }
    grep -qx 'Type=Application' "$desktop" || { echo "desktop entry Type is not Application" >&2; exit 1; }
    grep -qx 'Name=A3S GUI Dogfood' "$desktop" || { echo "desktop entry Name does not match A3S GUI Dogfood" >&2; exit 1; }
    grep -qx 'Exec=a3s-gui-dogfood' "$desktop" || { echo "desktop entry Exec does not match a3s-gui-dogfood" >&2; exit 1; }
    grep -q 'unsigned smoke artifact' "$readme" || { echo "handoff README does not identify an unsigned smoke artifact" >&2; exit 1; }
    packaging/check-bundle-manifest.sh "$bundle_dir" "$manifest" "linux-gtk4" "a3s-gui-dogfood-linux"

    echo "validated $bundle_dir"

# Stage the Windows WinUI dogfood bundle
bundle-winui:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            ;;
        *)
            echo "bundle-winui must run on Windows with the MSVC toolchain" >&2
            exit 1
            ;;
    esac

    cargo build --locked --release --target x86_64-pc-windows-msvc --features winui-native --example winui_dogfood

    bundle_dir="target/release/bundle/a3s-gui-dogfood-windows"
    rm -rf "$bundle_dir"
    mkdir -p "$bundle_dir"
    cp target/x86_64-pc-windows-msvc/release/examples/winui_dogfood.exe "$bundle_dir/A3SGuiDogfood.exe"
    cp packaging/windows/a3s-gui-dogfood.manifest "$bundle_dir/A3SGuiDogfood.exe.manifest"
    cp packaging/a3s-gui-dogfood-README.txt "$bundle_dir/README.txt"
    packaging/write-bundle-manifest.sh "$bundle_dir" "$bundle_dir/MANIFEST.txt" "windows-winui" "a3s-gui-dogfood-windows"

    echo "staged $bundle_dir"

# Validate the staged Windows WinUI dogfood bundle
check-bundle-winui:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            ;;
        *)
            echo "check-bundle-winui must run on Windows with the MSVC toolchain" >&2
            exit 1
            ;;
    esac

    bundle_dir="target/release/bundle/a3s-gui-dogfood-windows"
    binary="$bundle_dir/A3SGuiDogfood.exe"
    manifest="$bundle_dir/A3SGuiDogfood.exe.manifest"
    readme="$bundle_dir/README.txt"
    bundle_manifest="$bundle_dir/MANIFEST.txt"

    [[ -s "$binary" ]] || { echo "missing WinUI dogfood executable: $binary" >&2; exit 1; }
    [[ -f "$manifest" ]] || { echo "missing WinUI dogfood manifest: $manifest" >&2; exit 1; }
    [[ -f "$readme" ]] || { echo "missing WinUI handoff README: $readme" >&2; exit 1; }
    [[ -f "$bundle_manifest" ]] || { echo "missing WinUI bundle manifest: $bundle_manifest" >&2; exit 1; }
    grep -q 'name="A3S.GUI.Dogfood"' "$manifest" || { echo "manifest assembly identity does not match A3S.GUI.Dogfood" >&2; exit 1; }
    grep -q '<dpiAwareness' "$manifest" || { echo "manifest is missing dpiAwareness" >&2; exit 1; }
    grep -q 'unsigned smoke artifact' "$readme" || { echo "handoff README does not identify an unsigned smoke artifact" >&2; exit 1; }
    packaging/check-bundle-manifest.sh "$bundle_dir" "$bundle_manifest" "windows-winui" "a3s-gui-dogfood-windows"

    echo "validated $bundle_dir"

# Check all planning adapters without native OS bindings
check-platforms:
    cargo check --locked --all-targets --features appkit,winui,gtk4

# Check the native backend that matches this operating system
check-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo check --locked --all-targets --features appkit-native
            ;;
        Linux)
            cargo check --locked --all-targets --features gtk4-native
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo check --locked --all-targets --features winui-native
            ;;
        *)
            echo "unsupported operating system for native GUI checks: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Check the Windows dogfood target from any host with the target installed
check-winui:
    cargo check --locked --all-targets --target x86_64-pc-windows-msvc --features winui-native

# ============================================================================
# Test
# ============================================================================

# Run the default Rust test suite
test:
    cargo test --locked

# Run protocol and native runtime examples as tests
test-examples:
    cargo test --locked --examples

# Run adapter planning tests without native OS bindings
test-platforms:
    cargo test --locked --features appkit,winui,gtk4

# Prove the runtime core builds without SWC or the built-in design system
check-core:
    cargo check --locked --no-default-features --lib
    cargo check --locked --no-default-features --features authoring --lib

# Run native-feature library tests for this operating system
test-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo test --locked --lib --features appkit-native
            ;;
        Linux)
            cargo test --locked --lib --features gtk4-native
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo test --locked --lib --features winui-native
            ;;
        *)
            echo "unsupported operating system for native GUI tests: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Run the complete host-native CI gate locally
native-ci: test-native check-native

# Print the required native input automation matrix for one backend
native-input-manifest BACKEND:
    cargo run --locked --quiet --bin a3s-gui-native-input-conformance -- manifest "{{ BACKEND }}"

# Strictly verify an operating-system automation evidence artifact
native-input-conformance EVIDENCE:
    cargo run --locked --quiet --bin a3s-gui-native-input-conformance -- verify "{{ EVIDENCE }}"

# Capture the complete 98-case WinUI OS-input smoke artifact
winui-input-smoke EVIDENCE:
    cargo run --locked --quiet --no-default-features --features winui-native --bin a3s-gui-winui-input-smoke -- "{{ EVIDENCE }}"

# Lint every target and deny high-confidence Clippy and Rust warnings
clippy:
    cargo clippy --locked --all-targets --features appkit,winui,gtk4 -- -A clippy::all -D clippy::correctness -D clippy::suspicious -A clippy::unnecessary_get_then_check -D unused

# Build crate documentation and fail on rustdoc warnings
doc-check:
    RUSTDOCFLAGS="-D warnings" cargo doc --locked --no-deps --document-private-items

# Run the full local verification suite
verify: fmt-check check-core clippy doc-check test test-examples test-platforms diff-check

# Run dogfood reducer and protocol-boundary regression tests
dogfood-regression:
    cargo test --locked --example dogfood_session -- --nocapture

# Run one Rust test filter with output
test-one TEST:
    cargo test --locked {{ TEST }} -- --nocapture

# ============================================================================
# Formatting
# ============================================================================

# Format Rust code
fmt:
    cargo fmt --all

# Check Rust formatting
fmt-check:
    cargo fmt --all --check

# Check whitespace in the current git diff
diff-check:
    git diff --check

# ============================================================================
# Examples
# ============================================================================

# Run the headless dogfood session
dogfood:
    cargo run --locked --example dogfood_session

# Run the native dogfood app for this operating system
dogfood-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo run --locked --features appkit-native --example appkit_dogfood
            ;;
        Linux)
            cargo run --locked --features gtk4-native --example gtk4_dogfood
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo run --locked --features winui-native --example winui_dogfood
            ;;
        *)
            echo "unsupported operating system for native GUI dogfood: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Run the native controls smoke app for this operating system
controls-native:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo run --locked --features appkit-native --example appkit_controls
            ;;
        Linux)
            cargo run --locked --features gtk4-native --example gtk4_controls
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo run --locked --features winui-native --example winui_controls
            ;;
        *)
            echo "unsupported operating system for native GUI controls: $(uname -s)" >&2
            exit 1
            ;;
    esac

# Run the native calculator app for this operating system
calculator:
    cargo run --locked --features {{ native-backend }}-native --example {{ native-backend }}_calculator

# Run the native semantic component playground for this operating system
playground:
    #!/usr/bin/env bash
    set -euo pipefail

    case "$(uname -s)" in
        Darwin)
            cargo run --locked --features appkit-native --example appkit_component_playground
            ;;
        Linux)
            cargo run --locked --features gtk4-native --example gtk4_component_playground
            ;;
        MINGW*|MSYS*|CYGWIN*|Windows_NT)
            cargo run --locked --features winui-native --example winui_component_playground
            ;;
        *)
            echo "unsupported operating system for native GUI component playground: $(uname -s)" >&2
            exit 1
            ;;
    esac