27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# CLAUDE.md — rust/
|
|
|
|
Meow v2 workspace (Rust rewrite of meowlib / meowsrv / meowcli). Protocol v2 is a clean break:
|
|
no wire compatibility with the Go v1 stack.
|
|
|
|
* Read `ROADMAP.md` first: pick the next ⬜ lot, update its status and the journal when done.
|
|
* `ARCHITECTURE.md` is the design reference (crypto constructions, handshake, server API). Keep it in sync.
|
|
* Toolchain lives in `~/.cargo/bin` (not on PATH by default): `export PATH=$HOME/.cargo/bin:$PATH`.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
scripts/check.sh # fmt --check, clippy -D warnings, cargo test --workspace
|
|
tests/e2e.sh # full CLI + 2 servers scenario; E2E_STORAGE=redis://... for Redis
|
|
scripts/ffi-test.sh # regenerate Dart bindings (flutter_rust_bridge 2.13.0) + Dart tests in ../bastet
|
|
```
|
|
|
|
## Rules
|
|
|
|
* `meow-core` does no I/O and takes time as a parameter. Keep it that way.
|
|
* No `unsafe` (except the generated `meow-ffi/src/frb_generated.rs`, never edited by hand); no
|
|
`unwrap`/`expect` in library code outside tests.
|
|
* `meow-ffi/src/api/` is the Dart API: after changing it, run `scripts/ffi-test.sh`.
|
|
* Persist ratchet/contact state **before** sending the resulting bytes.
|
|
* `proto/meow.proto` is the single wire schema (compiled by protox, no protoc needed). Bump/extend, never renumber.
|
|
* Never log keys, mailbox ids or message content at `info` level.
|