Files
meow/CLAUDE.md
T
2026-11-20 21:47:33 +01:00

1.1 KiB

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

scripts/check.sh      # fmt --check, clippy -D warnings, cargo test --workspace
tests/e2e.sh          # full CLI + 2 servers scenario; E2E_STORAGE=redis://... for Redis

Rules

  • meow-core does no I/O and takes time as a parameter. Keep it that way.
  • No unsafe (except the future meow-ffi); no unwrap/expect in library code outside tests.
  • 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.