# Reviewer Guide
rustensor demonstrates a small binary format implemented in Rust with:
- fixed binary header design
- explicit format versioning
- defensive decoding
- typed checkpoint metadata
- F32 tensor layer support
- tensor shape validation
- payload length validation
- SHA-256 payload integrity verification
- executable examples
- automated QA through GitHub Actions
This crate is intentionally small.
It does not train models.
It does not run inference.
It does not replace ONNX, GGUF or SafeTensors.
Its value is in format design, validation, integrity checking and auditable Rust code.
## Recommended review commands
```powershell
cargo fmt --check
cargo check --all-targets
cargo clippy --all-targets -- -D warnings
cargo test
cargo doc --no-deps
cargo run --example save_checkpoint
cargo run --example load_checkpoint
```
## What to review first
Recommended files:
- `src/format.rs`
- `src/checkpoint.rs`
- `src/weights.rs`
- `src/writer.rs`
- `src/reader.rs`
- `src/integrity.rs`
- `tests/format_header_test.rs`
- `tests/checkpoint_model_test.rs`
- `tests/checkpoint_io_test.rs`
- `tests/integrity_test.rs`
## Security note
rustensor currently provides integrity verification, not authenticity.
SHA-256 can detect accidental corruption or unintended modification.
It does not prove file origin.
Authenticity would require HMAC, digital signatures or another trust mechanism.
Those mechanisms are outside the scope of version `0.1.0`.