navian-memcheck-cli 0.1.0

Command-line soak runner for navian-memcheck: run any command under load and gate CI on the plateau property — its RSS must level off after warmup.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# navian-memcheck (CLI)

Soak **any** command under load and gate CI on the plateau property: after warmup,
its resident memory must level off. No code changes to the target — point it at
your built binary.

```
navian-memcheck soak --cmd "./target/release/my-server --load" \
  --duration 20m --interval 5s --slope-budget 2mb --max 6gb --format json
```

It spawns the command, samples its RSS on the interval, fits a line through the
back half, and exits:

- `0` — memory plateaued (and stayed under `--max`)
- `1` — still growing, or exceeded `--max`
- `2` — usage error, the target crashed mid-soak, or the run was inconclusive

Install with `cargo install navian-memcheck-cli`. See the
[library](../navian-memcheck) for the in-test assertion.

## License

Apache-2.0.