wvq-cli 0.1.0-alpha.3

wvq command-line surface for Weavatrix Quality
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# wvq-cli

Command-line surface for **[Weavatrix Quality](https://github.com/Weavatrix/weavatrix-quality)** (`wvq`).

Alpha `0.1.0-alpha.3` — crates and APIs may change before 1.0.
**Primary install for most users is npm:** [`@weavatrix/wvq`](https://www.npmjs.com/package/@weavatrix/wvq).

## Install

```sh
cargo install wvq-cli --version 0.1.0-alpha.3
# or
npx @weavatrix/wvq@0.1.0-alpha.3 --help
```

The published binary name is `wvq`.

## Examples

```sh
wvq --repo /path/to/app doctor
wvq --repo /path/to/app init
wvq --repo /path/to/app spec validate --change checkout-fix
wvq --repo /path/to/app plan --change checkout-fix

wvq --repo /path/to/app run \
  --change checkout-fix \
  --base origin/main \
  --head HEAD \
  --scope impacted \
  --evidence-policy minimal

wvq --repo /path/to/app status
wvq --repo /path/to/app verify --change checkout-fix
wvq --repo /path/to/app verify --change checkout-fix --observe-only true
wvq --repo /path/to/app explain <id>

wvq --repo /path/to/app select --change checkout-fix --base origin/main --head WORKTREE
wvq --repo /path/to/app debt --change checkout-fix --base origin/main --head HEAD
wvq --repo /path/to/app record --change checkout-fix --route /checkout
```

### Typical agent / human loop

```text
doctor → spec validate → plan → run (impacted) → verify → explain
```

### Exit codes

| Code | Meaning |
| --- | --- |
| 0 | ok / observe-only |
| 1 | unresolved evidence / failure |
| 2 | blocking contradicted verify |

## Related crates

| Crate | Role |
| --- | --- |
| [`wvq-mcp`](https://crates.io/crates/wvq-mcp) | MCP host |
| [`wvq-bench`](https://crates.io/crates/wvq-bench) | Impacted-vs-full shadow |
| [`qualityd`](https://crates.io/crates/qualityd) | Local Studio HTTP |

Library crates in this family are **unstable alpha** — do not treat them as a
stable public API yet.

## Docs & examples

- Product README: https://github.com/Weavatrix/weavatrix-quality#readme
- Copy-paste examples: https://github.com/Weavatrix/weavatrix-quality/tree/main/examples
- CHANGELOG: https://github.com/Weavatrix/weavatrix-quality/blob/main/CHANGELOG.md

## License

MIT