ranvier-cli 0.1.1

CLI for the Ranvier Typed Decision Engine
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

# Ranvier CLI


The Ranvier CLI provides schematic and trace tooling for the Ranvier Typed Decision Engine.

## Install


```bash
cargo install ranvier-cli
```

## Usage


```bash
ranvier --help
```

## Common Commands


Generate a schematic JSON from a workspace example:

```bash
ranvier schematic basic-schematic --output schematic.json
```

Generate trace projection artifacts from a schematic:

```bash
ranvier status projection-from-schematic basic-schematic \
  --output ./dist/trace \
  --circuit-version 0.1.0
```

Generate projection artifacts from a timeline capture:

```bash
ranvier status projection-from-timeline ./dist/sample.timeline.json \
  --output ./dist/trace \
  --service "Ranvier Service" \
  --circuit-id order_api \
  --circuit-version 0.1.0
```

Generate projection artifacts directly from an example:

```bash
ranvier status projection-from-example order-processing-demo \
  --output ./dist/trace-order \
  --service "Ranvier Service" \
  --circuit-id order_processing \
  --circuit-version 0.1.0
```

Run the repository smoke check for `projection-from-example`:

```powershell
pwsh ./cli/scripts/smoke_projection_from_example.ps1
```

Run projection drift check (`example -> timeline -> projection` equivalence):

```powershell
pwsh ./cli/scripts/projection_drift_check.ps1
```

## Notes

- The CLI expects example names from the workspace when used in repository mode.
- Projection artifacts feed the inspector endpoints `/trace/public` and `/trace/internal`.