aristo-cli 0.1.0

Aristo CLI binary (the `aristo` command).
Documentation 
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

# Tiered badge default — `aristo badge --metric=tier`

Source: `docs/decisions/badge-tier-scheme.md` D7 (visible-score formula),
D8 (tier cutoffs), D11 (visual palette + locked logo).

Slice 31.5 makes `tier` the default headline metric for `aristo badge`,
replacing slice 31's `aristos-count`. The slice-31 surface stays
accessible via `--metric=count`; the verification-rate variant from the
visibility-artifacts mockup is exposed as `--metric=rate`. The
`--metric` flag changes which value lands in the SVG body — the
progress lines always report `aristos-count`, `verification-rate`,
`score`, and `tier` so the diagnostic surface is uniform regardless of
which headline metric the user picked.

## Default invocation places the tier in the SVG value half

```console
$ aristo badge --out=docs/badge.svg
→ Reading .aristo/index.toml … ok
→ Computing metrics: aristos-count=[..], verification-rate=[..], score=[..], tier=[..]
→ Writing docs/badge.svg ([..] style)
ok: badge written. Embed in README:

  ![aristo verified](docs/badge.svg)

```

## `--metric=count` preserves the slice-31 total-count surface

```console
$ aristo badge --metric=count --out=docs/badge.svg
→ Reading .aristo/index.toml … ok
→ Computing metrics: aristos-count=[..], verification-rate=[..], score=[..], tier=[..]
→ Writing docs/badge.svg ([..] style)
ok: badge written. Embed in README:

  ![aristo verified](docs/badge.svg)

```

## `--metric=rate` exposes verification-rate as the headline value

```console
$ aristo badge --metric=rate --out=docs/badge.svg
→ Reading .aristo/index.toml … ok
→ Computing metrics: aristos-count=[..], verification-rate=[..], score=[..], tier=[..]
→ Writing docs/badge.svg ([..] style)
ok: badge written. Embed in README:

  ![aristo verified](docs/badge.svg)

```

## `--metric=tier` is identical to the default

```console
$ aristo badge --metric=tier --out=docs/badge.svg
→ Reading .aristo/index.toml … ok
→ Computing metrics: aristos-count=[..], verification-rate=[..], score=[..], tier=[..]
→ Writing docs/badge.svg ([..] style)
ok: badge written. Embed in README:

  ![aristo verified](docs/badge.svg)

```

## Unknown `--metric` value is rejected at parse time

```console
$ aristo badge --metric=quality --out=docs/badge.svg
? 2
error: unknown --metric `quality`; expected `count`, `rate`, or `tier`

```