justfile

set shell := ["/bin/bash", "-c"]
set dotenv-load := true
set positional-arguments := true

# === Colors ===
# Generated via printf because just 1.51.0 doesn't accept \033 (octal) or \x1b (hex)
# escape sequences in string variables. Newer just versions handle both.
GREEN := `printf '\033[0;32m'`
YELLOW := `printf '\033[0;33m'`
RED := `printf '\033[0;31m'`
RESET := `printf '\033[0m'`

# === Dev ===

dev:
    @cd apps/rook && cargo watch -x check -x test -x clippy

# === Dev Container (Docker) ===
# Run rook in an isolated container to smoke-test without touching the host OS.
# Wraps dev/run.sh + dev/docker-compose.dev.yml.

dev-build:
    @./dev/run.sh build

dev-run: dev-build
    @./dev/run.sh up

dev-up:
    @./dev/run.sh up

dev-down:
    @./dev/run.sh down

dev-logs:
    @./dev/run.sh logs

dev-shell:
    @./dev/run.sh shell

dev-restart:
    @./dev/run.sh restart

dev-status:
    @./dev/run.sh status

dev-clean:
    @./dev/run.sh clean

# === Lint ===

check:
    cargo check --workspace

clippy:
    cargo clippy --workspace --all-targets -- -D warnings

clippy-fail-fast:
    cargo clippy --workspace --all-targets -- -D warnings || true
    @echo "{{GREEN}}Clippy complete{{RESET}}"

fmt:
    cargo fmt --all

fmt-check:
    cargo fmt --all -- --check

# === Test ===

test:
    cargo test --workspace --all-features

test-unit:
    cargo test --workspace --lib

test-integration:
    cargo test --workspace --test '*'

test-doc:
    cargo test --workspace --doc

# === E2E Tests ===

test-e2e-build:
    @echo "{{YELLOW}}Building Docker image for e2e tests...{{RESET}}"
    docker build -f Dockerfile.dev -t rook:e2e-api-keys .

test-e2e:
    @echo "{{YELLOW}}Running E2E tests (Playwright)...{{RESET}}"
    ./dev/e2e/run-api-keys-e2e.sh --test

test-e2e-dev:
    @echo "{{YELLOW}}Starting E2E dev environment (manual testing)...{{RESET}}"
    ./dev/e2e/run-api-keys-e2e.sh

test-e2e-cleanup:
    @echo "{{YELLOW}}Cleaning up E2E containers...{{RESET}}"
    ./dev/e2e/run-api-keys-e2e.sh --cleanup

test-e2e-install-deps:
    @echo "{{YELLOW}}Installing dashboard dependencies...{{RESET}}"
    cd apps/rook/dashboard && pnpm install

coverage:
    cargo llvm-cov --workspace --html

coverage-text:
    cargo llvm-cov --workspace

# === Build ===

build:
    cargo build --workspace --release

build-app:
    cargo build -p rook --release

build-targets:
    # Cross-compile for all targets
    @echo "{{YELLOW}}Building for macOS Intel...{{RESET}}"
    cargo build -p rook --release --target x86_64-apple-darwin
    @echo "{{YELLOW}}Building for macOS ARM64...{{RESET}}"
    cargo build -p rook --release --target aarch64-apple-darwin
    @echo "{{YELLOW}}Building for Linux x86_64...{{RESET}}"
    cargo build -p rook --release --target x86_64-unknown-linux-gnu
    @echo "{{YELLOW}}Building for Linux ARM64...{{RESET}}"
    cargo build -p rook --release --target aarch64-unknown-linux-gnu
    @echo "{{YELLOW}}Building for Windows x86_64...{{RESET}}"
    cargo build -p rook --release --target x86_64-pc-windows-msvc
    @echo "{{YELLOW}}Building for Windows ARM64...{{RESET}}"
    cargo build -p rook --release --target aarch64-pc-windows-msvc
    @echo "{{GREEN}}All targets built!{{RESET}}"

# === Run ===

# Run the personal coding agent (e.g. just huginn-run --provider mock run "list files")
huginn-run *args:
    cargo run -p huginn -- "$@"

huginn-architecture:
    python3 .github/scripts/check-huginn-architecture.py

huginn-test: huginn-architecture
    cargo test -p huginn-core -p huginn-application -p huginn-runtime -p huginn-presentation -p huginn --all-features

# Run the backend (rook) in dev mode
run:
    ROOK_CONFIG=$HOME/.config/cortex/rook.toml cargo run -p rook

# Run the Vue dashboard dev server (requires pnpm install first)
run-dashboard:
    cd apps/rook/dashboard && pnpm dev

# Install dashboard npm dependencies (run once after cloning)
dashboard-install:
    cd apps/rook/dashboard && pnpm install

# === DB ===

# Reset the SQLite database — removes rook.db, rook.db-wal, rook.db-shm
# Always delete all three files together; a leftover -wal against a fresh DB
# causes SQLite error 522 ("file truncated") on the next startup.
db-reset:
    @rm -f ~/.local/share/cortex/rook/rook.db{,-wal,-shm}
    @echo "{{GREEN}}Database reset — rook.db, rook.db-wal, rook.db-shm removed{{RESET}}"

# Kill any process occupying port 3773 (stale rook instance)
kill-backend:
    @lsof -ti :3773 | xargs kill -9 2>/dev/null && echo "{{GREEN}}Killed process on :3773{{RESET}}" || echo "{{YELLOW}}Nothing running on :3773{{RESET}}"

# One-shot first-time setup: install dashboard deps + verify Rust toolchain
setup:
    @echo "{{YELLOW}}Installing dashboard dependencies...{{RESET}}"
    cd apps/rook/dashboard && pnpm install
    @echo "{{YELLOW}}Verifying Rust toolchain...{{RESET}}"
    rustup show
    @echo "{{GREEN}}Setup complete — run 'just run' in one terminal and 'just run-dashboard' in another{{RESET}}"

# === Quality ===

audit:
    cargo audit --no-fetch

outdated:
    cargo outdated -r

unused:
    cargo udeps --workspace

hack:
    cargo hack --workspace --optional-deps-metadata

spellcheck:
    cargo-spellcheck check --all

# === Providers ===

check-providers:
    cargo check -p providers-openai -p providers-anthropic -p providers-ollama -p providers-gemini -p providers-groq

# === Infra ===

check-infra:
    cargo check -p transport-axum -p cache-memory -p audit-sqlite -p observability

# === Domain ===

check-domain:
    cargo check -p shared-kernel -p rook-core

# === Doc ===

doc:
    cargo doc --workspace --no-deps --document-private-items

doc-open:
    cargo doc --workspace --no-deps --open

# === Clean ===

clean:
    cargo clean
    cargo llvm-cov clean --workspace

push *args:
    git push "$@" && just clean

# === Build artifact diagnostics ===

# Show the largest top-level Cargo artifact directories before cleaning.
target-size:
    #!/usr/bin/env bash
    set -euo pipefail
    if [[ ! -d target ]]; then
      echo "target/ does not exist — no local Cargo artifacts to measure"
      exit 0
    fi
    shopt -s nullglob
    paths=(target target/*)
    printf 'Cargo target size by directory (GiB):\n'
    du -sk "${paths[@]}" | sort -n | tail -20 | awk '{ printf "%7.2f GiB  %s\n", $1 / 1048576, $2 }'

# === Full CI (local) ===
# Each ci-* recipe is independent and can be run standalone.
# ci-local chains them sequentially — stops on first failure with a clear banner.
# Run individual steps with: just ci-lint, just ci-test-rust, etc.

_ci-header phase:
    @echo "{{YELLOW}}🔍  {{ phase }}{{RESET}}"

ci-lint: (_ci-header "1/9 markdown-lint...")
    @pnpm exec markdownlint-cli2 "*.md" "docs/**/*.md"

ci-fmt: (_ci-header "2/9 fmt-check...")
    @cargo fmt --all -- --check

ci-clippy: (_ci-header "3/9 clippy...")
    @cargo clippy --workspace --all-targets -- -D warnings

ci-check: (_ci-header "4/9 cargo check...")
    @python3 .github/scripts/check-huginn-architecture.py
    @cargo check --workspace

ci-test-rust: (_ci-header "5/9 cargo test (Rust)...")
    @cargo test --workspace --all-features

ci-test-vitest: (_ci-header "6/9 vitest (Frontend)...")
    @cd apps/rook/dashboard && pnpm exec vitest run

ci-doc: (_ci-header "7/9 cargo doc...")
    @RUSTDOCFLAGS="--document-private-items -D warnings" cargo doc --workspace --no-deps

ci-audit: (_ci-header "8/9 cargo audit...")
    @cargo audit --no-fetch || true

ci-e2e: (_ci-header "9/9 e2e (Playwright)...")
    @./dev/e2e/run-api-keys-e2e.sh --test

# ---------------------------------------------------------------------------
# ci-local: sequential fail-fast with clear error banner
# ---------------------------------------------------------------------------
# Runs every ci-* step in order. On first failure, prints a red banner with
# the step name and elapsed time, then exits immediately.
ci-local:
    #!/usr/bin/env bash
    set -euo pipefail
    G="$(printf '\033[0;32m')" Y="$(printf '\033[0;33m')" R="$(printf '\033[0;31m')" N="$(printf '\033[0m')"
    TOTAL_START=$SECONDS
    run_step() {
      local label="$1"; shift
      echo "${Y}🔍  ${label}${N}"
      local step_start=$SECONDS
      if "$@"; then
        local elapsed=$(( SECONDS - step_start ))
        echo "${G}   ✓ ${label} (${elapsed}s)${N}"
      else
        local elapsed=$(( SECONDS - step_start ))
        echo ""
        echo "${R}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
        echo "${R}  ✗ FAILED at: ${label} (${elapsed}s)${N}"
        echo "${R}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
        echo ""
        exit 1
      fi
    }
    echo ""
    echo "${Y}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo "${Y}  CI LOCAL — fail-fast on first error${N}"
    echo "${Y}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo ""
    run_step "1/9 markdown-lint"   pnpm exec markdownlint-cli2 "*.md" "docs/**/*.md"
    run_step "2/9 fmt-check"       cargo fmt --all -- --check
    run_step "3/9 clippy"          cargo clippy --workspace --all-targets -- -D warnings
    run_step "4/9 architecture + cargo check" bash -c 'python3 .github/scripts/check-huginn-architecture.py && cargo check --workspace'
    run_step "5/9 cargo test"      cargo test --workspace --all-features
    run_step "6/9 vitest"          bash -c 'cd apps/rook/dashboard && pnpm exec vitest run'
    run_step "7/9 cargo doc"       bash -c 'RUSTDOCFLAGS="--document-private-items -D warnings" cargo doc --workspace --no-deps'
    run_step "8/9 cargo audit"     bash -c 'cargo audit --no-fetch || true'
    run_step "9/9 e2e"             ./dev/e2e/run-api-keys-e2e.sh --test
    TOTAL=$(( SECONDS - TOTAL_START ))
    echo ""
    echo "${G}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo "${G}  CI LOCAL — ALL PASSED ✓  (${TOTAL}s total)${N}"
    echo "${G}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo ""

# Run only linting + formatting stages
ci-lint-only:
    @just ci-lint
    @just ci-fmt
    @echo "{{GREEN}}Lint stages passed{{RESET}}"

# Run only compile + type-check stages
ci-check-only:
    @just ci-clippy
    @just ci-check
    @echo "{{GREEN}}Check stages passed{{RESET}}"

# Run only test stages (fast feedback loop)
ci-test-only:
    @just ci-test-rust
    @just ci-test-vitest
    @echo "{{GREEN}}Test stages passed{{RESET}}"

# Run CI without E2E (skip Docker dependency for quick iteration)
ci-ci:
    #!/usr/bin/env bash
    set -euo pipefail
    G="$(printf '\033[0;32m')" Y="$(printf '\033[0;33m')" R="$(printf '\033[0;31m')" N="$(printf '\033[0m')"
    TOTAL_START=$SECONDS
    run_step() {
      local label="$1"; shift
      echo "${Y}🔍  ${label}${N}"
      local step_start=$SECONDS
      if "$@"; then
        local elapsed=$(( SECONDS - step_start ))
        echo "${G}   ✓ ${label} (${elapsed}s)${N}"
      else
        local elapsed=$(( SECONDS - step_start ))
        echo ""
        echo "${R}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
        echo "${R}  ✗ FAILED at: ${label} (${elapsed}s)${N}"
        echo "${R}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
        echo ""
        exit 1
      fi
    }
    echo ""
    echo "${Y}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo "${Y}  CI (no E2E) — fail-fast on first error${N}"
    echo "${Y}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo ""
    run_step "1/8 markdown-lint"   pnpm exec markdownlint-cli2 "*.md" "docs/**/*.md"
    run_step "2/8 fmt-check"       cargo fmt --all -- --check
    run_step "3/8 clippy"          cargo clippy --workspace --all-targets -- -D warnings
    run_step "4/8 cargo check"     cargo check --workspace
    run_step "5/8 cargo test"      cargo test --workspace --all-features
    run_step "6/8 vitest"          bash -c 'cd apps/rook/dashboard && pnpm exec vitest run'
    run_step "7/8 cargo doc"       bash -c 'RUSTDOCFLAGS="--document-private-items -D warnings" cargo doc --workspace --no-deps'
    run_step "8/8 cargo audit"     bash -c 'cargo audit --no-fetch || true'
    TOTAL=$(( SECONDS - TOTAL_START ))
    echo ""
    echo "${G}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo "${G}  CI (no E2E) — ALL PASSED ✓  (${TOTAL}s total)${N}"
    echo "${G}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${N}"
    echo ""

# === Release ===

release-dry-run:
    @echo "{{YELLOW}}Running release-please dry-run...{{RESET}}"
    npx release-please release-pr --token=$$GITHUB_TOKEN --dry-run

# === Help ===

help:
    @echo "cortex/rook - available commands:"
    @echo ""
    @echo "Quality:"
    @echo "  just fmt          - Format code"
    @echo "  just fmt-check    - Check formatting"
    @echo "  just clippy       - Run clippy (deny warnings)"
    @echo "  just test         - Run all tests (unit + integration + doc)"
    @echo "  just test-unit    - Run unit tests only (lib)"
    @echo "  just test-integration - Run integration tests"
    @echo "  just coverage     - Generate HTML coverage report"
    @echo "  just audit        - Check for vulnerabilities"
    @echo "  just ci-local     - Run full CI locally (fail-fast: stops on first error)"
    @echo "  just ci-ci        - Full CI without E2E (no Docker needed)"
    @echo "  just ci-lint-only - Lint + fmt only"
    @echo "  just ci-check-only - Clippy + cargo check only"
    @echo "  just ci-test-only - Rust + Vitest tests only"
    @echo ""
    @echo "E2E Tests (Playwright):"
    @echo "  just test-e2e-build      - Build Docker image for e2e"
    @echo "  just test-e2e             - Run Playwright e2e tests"
    @echo "  just test-e2e-dev        - Start e2e env for manual testing"
    @echo "  just test-e2e-cleanup    - Stop/remove e2e containers"
    @echo "  just test-e2e-install-deps - Install dashboard dependencies"
    @echo ""
    @echo "Build:"
    @echo "  just build        - Build release (all targets)"
    @echo "  just build-app    - Build rook binary"
    @echo "  just build-targets - Cross-compile for all platforms"
    @echo "  just target-size  - Show Cargo artifact sizes before cleaning"
    @echo ""
    @echo "Dev:"
    @echo "  just setup           - First-time setup (dashboard deps + toolchain check)"
    @echo "  just dev             - Watch mode with check+test+clippy"
    @echo "  just run             - Run rook backend"
    @echo "  just run-dashboard   - Run Vue dashboard dev server (localhost:4747)"
    @echo "  just dashboard-install - Install dashboard npm dependencies"
    @echo "  just push [args...]   - Push and clean Cargo artifacts on success"
    @echo ""
    @echo "DB:"
    @echo "  just db-reset        - Delete rook.db + WAL files (clean slate)"
    @echo "  just kill-backend    - Kill stale process on port 3773"
    @echo ""
    @echo "Dev Container (Docker — no host pollution):"
    @echo "  just dev-run      - Build image + start container (waits for /health)"
    @echo "  just dev-up       - Start container (builds image if missing)"
    @echo "  just dev-build    - Build the rook:dev image only"
    @echo "  just dev-down     - Stop and remove container"
    @echo "  just dev-logs     - Tail container logs"
    @echo "  just dev-shell    - Shell into the running container"
    @echo "  just dev-restart  - Restart the container"
    @echo "  just dev-status   - Container + /health status"
    @echo "  just dev-clean    - Remove image and container"
    @echo ""
    @echo "Doc:"
    @echo "  just doc          - Generate docs"
    @echo "  just doc-open     - Generate and open docs"