Status: Active OpenSpec proposal; not implemented or deployed. The source under
openspec/changes/is authoritative.
Context
This greenfield tracer establishes only contracts needed by later capabilities.
Goals / Non-Goals
- Goals: discoverable command families, deterministic configuration, domain-safe finding fields, and stable exit categories.
- Non-goals: parsing source, producing findings, serializing output, applying gate policy, generating benchmarks, or invoking toolchains.
Decisions
- Use a Cargo workspace with a thin
cruabinary and library-owned CLI/configuration/domain contracts. - Discover at most one
crua.tomlby walking from the working directory to the repository root; apply precedenceCLI > CRUA_* environment > crua.toml > EARS defaults. Invalid values fail rather than falling through. - Reserve exits
0for successful command handling,1for a future policy/gate failure, and2for configuration or operational failure. This change can exercise only0and2. - Model closed vocabularies as Rust enums and require the REQ-5 finding fields at construction; do not add output-format serialization yet.
Risks / Trade-offs
- Reserved contracts constrain successors; snapshots make intentional breaking changes visible.
- Combining configuration and operational failures at exit
2limits shell-level diagnosis; structured diagnostics can distinguish them later.