AGENTS.md · git:20260225.b50130e · 2026-02-25 · sha256 656535cfe3b0e5e7

AGENTS.md git:20260225.b50130eA

Immutable. This exact content is served forever at /api/v1/blob/656535cfe3b0e5e7.

# AGENTS.md

## Cursor Cloud specific instructions

### Project overview

GarraIA is a multi-crate Rust workspace (`edition = "2024"`, `rust-version = "1.85"`). The main binary is `garraia-cli`; the HTTP/WS gateway lives in `garraia-gateway`.

### Build, lint, and test

- **Build all**: `cargo build` (from workspace root)
- **Build a single crate**: `cargo build -p garraia-gateway`
- **Test a single crate**: `cargo test -p garraia-gateway`
- **Test all**: `cargo test --workspace`
- **Lint**: `cargo clippy --workspace` (clippy is available via the installed toolchain)
- **Format check**: `cargo fmt --check`

### Notes

- The workspace uses `edition = "2024"` which requires Rust 1.85+. The VM ships with Rust 1.93.
- No external services (databases, Redis, etc.) are required for building or running tests; SQLite is bundled via `rusqlite` with the `bundled` feature.
- The gateway integration tests start their own ephemeral HTTP/WS servers on random ports — no manual server startup is needed.
- The `garraia-gateway` crate depends on many workspace crates; initial compilation can take ~45 s.