rototo 0.1.0-alpha.3

Control plane for runtime configuration of your application.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# Qualifier Resolution Reference

A qualifier answers one runtime question: does this named condition match the
context the application supplied?

Rototo evaluates qualifiers during variable resolution, and the CLI can resolve
qualifiers directly for debugging.

## Input

Qualifier resolution needs:

- a loaded, lint-clean workspace;
- a qualifier id;
- a JSON object context.

CLI:

```sh
rototo resolve account-config \
  --qualifier paid-account \
  --context account.plan=enterprise
```

SDK:

```rust
let result = workspace
    .resolve_qualifier("paid-account", &context)
    .await?;
```

## Evaluation

Rototo evaluates predicates in file order.

For each predicate:

1. Read the predicate attribute.
2. Apply the predicate operator.
3. Record the trace result.

All predicates are ANDed. If any predicate is false, the qualifier is false.

## Context Attributes

For a context attribute:

```toml
attribute = "account.plan"
```

rototo reads the JSON path from the context object. Missing paths fail
resolution.

## Qualifier Attributes

For a qualifier attribute:

```toml
attribute = "qualifier.paid-account"
```

rototo resolves the referenced qualifier and uses its boolean result as the
actual value for the predicate.

If qualifier references form a cycle, resolution fails with a qualifier cycle
error.

## Trace Shape

CLI `--json` and `inspect --context` expose qualifier traces:

```json
{
  "id": "paid-account",
  "value": true,
  "predicates": [
    {
      "index": 0,
      "kind": "compare",
      "attribute": "account.plan",
      "op": "in",
      "expected": ["growth", "enterprise"],
      "actual": "enterprise",
      "result": true
    }
  ]
}
```

Bucket predicates include a `bucket` object:

```json
{
  "index": 0,
  "kind": "bucket",
  "attribute": "account.id",
  "bucket": {
    "salt": "billing-policy-2026-06",
    "start": 0,
    "end": 1000,
    "value": 427
  },
  "result": true
}
```

## Error Boundaries

Qualifier resolution assumes lint has already validated workspace structure and
references. Runtime errors are still possible when the context does not satisfy
what the qualifier needs.

The usual production checks are:

- keep `schemas/context.schema.json` current;
- exercise important contexts in app tests;
- log enough trace or selected metadata to explain policy decisions.