Justfile

# Justfile for UbiCity v0.3
# Modern build orchestration for Deno + ReScript + WASM

# Default recipe
import? "contractile.just"

default:
    @just --list

# Run the Idris2 test suite (estate port 6/11; partial — core.test.ts only).
# Requires idris2 0.8.0+ on PATH.
test-core:
    @export IDRIS2_PREFIX="$(dirname "$(dirname "$(command -v idris2)")")" && \
        idris2 --build ubicity-tests.ipkg && \
        ./build/exec/ubicity-tests

# Setup development environment
setup:
    @echo "🔧 Setting up UbiCity development environment..."
    @echo "Installing Deno (if not installed)..."
    @command -v deno || curl -fsSL https://deno.land/install.sh | sh
    @echo "Checking for Rust..."
    @command -v cargo || (echo "Please install Rust: https://rustup.rs" && exit 1)
    @echo "Checking for ReScript..."
    @command -v rescript || npm install -g rescript
    @echo "Installing wasm-pack..."
    @command -v wasm-pack || cargo install wasm-pack
    @echo "✅ Setup complete!"

# Build all components
build: build-rescript build-wasm
    @echo "✅ Build complete!"

# Build ReScript to JavaScript
build-rescript:
    @echo "🔨 Building ReScript..."
    rescript build

# Build WASM from Rust
build-wasm:
    @echo "🦀 Building WASM..."
    cd wasm && cargo build --release --target wasm32-unknown-unknown
    @echo "🎯 Optimizing WASM..."
    wasm-opt -Oz -o wasm/pkg/ubicity_bg.wasm wasm/target/wasm32-unknown-unknown/release/ubicity_wasm.wasm || echo "wasm-opt not found, skipping optimization"

# Watch ReScript for changes
watch-rescript:
    rescript build -w

# Run all tests
test:
    deno test --allow-read --allow-write tests/

# Run tests in watch mode
test-watch:
    deno test --watch --allow-read --allow-write tests/

# Run benchmarks
bench:
    deno bench --allow-read --allow-write benchmarks/

# Format code
fmt:
    deno fmt
    rescript format -all

# Lint code
lint:
    deno lint

# Type check
check:
    deno check src/**/*.ts

# Clean build artifacts
clean:
    @echo "🧹 Cleaning build artifacts..."
    rescript clean
    rm -rf wasm/target
    rm -rf lib
    rm -rf coverage
    @echo "✅ Clean complete!"

# Compile to standalone executables
compile: build
    @echo "📦 Compiling standalone executables..."
    deno compile --allow-read --allow-write --output ./bin/ubicity src/cli.ts
    deno compile --allow-read --allow-write --output ./bin/ubicity-capture src/capture.ts
    @echo "✅ Executables created in ./bin/"

# Run the CLI
cli *ARGS:
    deno run --allow-read --allow-write src/cli.ts {{ARGS}}

# Capture an experience
capture MODE="quick":
    deno run --allow-read --allow-write src/capture.ts {{MODE}}

# Generate visualization
viz:
    deno run --allow-read --allow-write src/visualize.ts

# Generate report
report:
    deno run --allow-read --allow-write src/cli.ts report

# Show stats
stats:
    deno run --allow-read --allow-write src/cli.ts stats

# Development server with watch
dev:
    deno run --watch --allow-read --allow-write src/cli.ts

# Cache all dependencies
cache:
    deno cache --reload src/index.ts

# Show dependency tree
deps:
    deno info src/index.ts

# Update Deno dependencies
update:
    deno cache --reload src/index.ts

# Run all quality checks
qa: fmt lint check test
    @echo "✅ All quality checks passed!"

# CI/CD pipeline
ci: build qa compile
    @echo "✅ CI pipeline complete!"

# Create release build
release: clean build compile
    @echo "🎉 Release build complete!"
    @echo "Executables in ./bin/"
    @ls -lh ./bin/

# Run panic-attacker pre-commit scan
assail:
    @command -v panic-attack >/dev/null 2>&1 && panic-attack assail . || echo "panic-attack not found — install from https://github.com/hyperpolymath/panic-attacker"

# Self-diagnostic — checks dependencies, permissions, paths
doctor:
    @echo "Running diagnostics for ubicity..."
    @echo "Checking required tools..."
    @command -v just >/dev/null 2>&1 && echo "  [OK] just" || echo "  [FAIL] just not found"
    @command -v git >/dev/null 2>&1 && echo "  [OK] git" || echo "  [FAIL] git not found"
    @echo "Checking for hardcoded paths..."
    @grep -rn '$HOME\|$ECLIPSE_DIR' --include='*.rs' --include='*.ex' --include='*.res' --include='*.gleam' --include='*.sh' . 2>/dev/null | head -5 || echo "  [OK] No hardcoded paths"
    @echo "Diagnostics complete."

# Auto-repair common issues
heal:
    @echo "Attempting auto-repair for ubicity..."
    @echo "Fixing permissions..."
    @find . -name "*.sh" -exec chmod +x {} \; 2>/dev/null || true
    @echo "Cleaning stale caches..."
    @rm -rf .cache/stale 2>/dev/null || true
    @echo "Repair complete."

# Guided tour of key features
tour:
    @echo "=== ubicity Tour ==="
    @echo ""
    @echo "1. Project structure:"
    @ls -la
    @echo ""
    @echo "2. Available commands: just --list"
    @echo ""
    @echo "3. Read README.adoc for full overview"
    @echo "4. Read EXPLAINME.adoc for architecture decisions"
    @echo "5. Run 'just doctor' to check your setup"
    @echo ""
    @echo "Tour complete! Try 'just --list' to see all available commands."

# Open feedback channel with diagnostic context
help-me:
    @echo "=== ubicity Help ==="
    @echo "Platform: $(uname -s) $(uname -m)"
    @echo "Shell: $SHELL"
    @echo ""
    @echo "To report an issue:"
    @echo "  https://github.com/hyperpolymath/ubicity/issues/new"
    @echo ""
    @echo "Include the output of 'just doctor' in your report."


# Print the current CRG grade (reads from READINESS.md '**Current Grade:** X' line)
crg-grade:
    @grade=$$(grep -oP '(?<=\*\*Current Grade:\*\* )[A-FX]' READINESS.md 2>/dev/null | head -1); \
    [ -z "$$grade" ] && grade="X"; \
    echo "$$grade"

# Generate a shields.io badge markdown for the current CRG grade
# Looks for '**Current Grade:** X' in READINESS.md; falls back to X
crg-badge:
    @grade=$$(grep -oP '(?<=\*\*Current Grade:\*\* )[A-FX]' READINESS.md 2>/dev/null | head -1); \
    [ -z "$$grade" ] && grade="X"; \
    case "$$grade" in \
      A) color="brightgreen" ;; B) color="green" ;; C) color="yellow" ;; \
      D) color="orange" ;; E) color="red" ;; F) color="critical" ;; \
      *) color="lightgrey" ;; esac; \
    echo "[![CRG $$grade](https://img.shields.io/badge/CRG-$$grade-$$color?style=flat-square)](https://github.com/hyperpolymath/standards/tree/main/component-readiness-grades)"