006-cli-surface

CLI surface

Lifecycle approvedImplementation completeVerification unknownQualification unknown

Increment 2: `rustev`, a command-line host over the library. Plan check, compile and show against descriptor, rules-program, calibration and execution-policy files; run one snapshot through `rustev-runtime` on rules-program backends with a file evidence sink and optional bounded capture into a replay bundle; offline replay under an explicitly supplied trusted scope; evaluation reports with their detail and configuration companions, regression gates, and temperature fitting with its lineage record, through `rustev-eval`. Bounded file access, stable JSON output and distinct exit codes. No network, no hosting, no live inference beyond the deterministic rules backend.

Read the full pinned specification ↗

Relationships

depends on

depended on by

Claimed units

establishes

{
  "kind": "directory",
  "path": "crates/rustev-cli/"
}

extends

{
  "nature": "additive",
  "spec": "001-boundaries-and-authority",
  "unit": {
    "kind": "file",
    "path": "Cargo.lock"
  }
}

extends

{
  "nature": "additive",
  "spec": "001-boundaries-and-authority",
  "unit": {
    "kind": "file",
    "path": "Makefile"
  }
}

Source headings

006: CLI surface
1. Purpose
2. Territory
3. Behavior
3.1 Invocation and output
3.2 Exit codes
3.3 Bounded file access
3.4 `rustev plan check | compile | show`
3.5 `rustev run`
3.6 Capture and bundles on `run`
3.7 `rustev replay`
3.8 Task adapters, `rustev.task-adapter/1`
3.9 `rustev eval` and `rustev gate`
3.10 `rustev calibrate fit | qualify`
4. Out of scope
5. Observable negative cases
Acceptance
Verification
Implementation record
Decision history
Engineering choices
Tooling compatibility record (2026-10-02)

Frozen anchors

No frozen anchors declared.