Development commands

Run from the repository root. Toolchain and first launch: Build from source. Which checks each change needs: Testing workflows.

Goal	Command
Full desktop app	./scripts/start.sh
Install desktop app (macOS)	./scripts/install.sh
Frontend only	npm --prefix crates/ui run dev
Frontend typecheck	npm --prefix crates/ui run typecheck
Fast Rust lane	./scripts/test-fast.sh
Fast lane with execution tests	./scripts/test-fast.sh --execution
Full verification gate	./scripts/verify.sh (Rust tests = test-fast; desktop via ./scripts/verify.sh test)
Leg timing	./scripts/bench-test-legs.sh
Architecture checks only	./scripts/check-architecture.sh
Workflow acceptance	cargo nextest run -p orchestration --test workflow_acceptance --no-capture
Live AI smoke	STEP_WORKFLOW_LIVE_AI=1 STEP_WORKFLOW_LIVE_API_KEY=... STEP_WORKFLOW_LIVE_MODEL=... cargo nextest run -p orchestration --test live_workflow --run-ignored ignored-only --no-capture

Architecture check config

./scripts/check-architecture.sh

Machine-readable rules: ../../crates/workspace-checks/arch-check-rules.toml, owned by the workspace-check tooling. Human-readable rules: ../architecture/contract.md.

Verification quick path

Goal	Command
Compile loop	./scripts/check-fast.sh
Iterate	./scripts/test-fast.sh (+ --execution if touching runs)
Handoff / PR	./scripts/verify.sh
Full workspace Rust (incl. desktop)	./scripts/verify.sh test
Parallel agents on one machine	VERIFY_ISOLATE_TARGET=1 ./scripts/verify.sh

Default verify reuses ./target and runs the CI-aligned test-fast lane (no desktop; Bedrock/AWS off unless desktop/featured). Opt in to the full workspace with ./scripts/verify.sh test, and to mutation testing with ./scripts/verify.sh --deep.

Intentional changes to the engine's public surface need an updated crates/engine/tests/snapshots/public_api.txt (cargo +nightly public-api from crates/engine/).

Testing workflows lists checks by behavior.