Valinor CLI Reference
Valinor is Camber's CI-native quality-governance product. Its "API" is the valinor command surface — the deterministic gates, the over-time audit spine, the governance commands, and the init propagator that scaffolds them into a target repo. This reference documents every command, plus the governance.config.yml and claims.yml schemas.
Audience and source of truth
This reference is for developers integrating Valinor into a repo and agents invoking the CLI. Every command is invoked as valinor <command> [path] (the valinor bin maps to dist/cli.js), or via npx @cmbrcreative/valinor <command> once installed. Each command emits a gate telemetry event and fails closed — a non-zero exit on any drift, error, or unreadable input.
The authoritative source is the code: src/cli.ts (the dispatch registry) and docs/guide/commands.md (the in-repo developer reference). If this site ever disagrees with those, the code wins.
Guides
CI gates
The deterministic per-PR gates: doctrine, docs, dependency health, change narrative.
Resources
init
Propagate the versioned doctrine into a target repo and scaffold the gates, claims, config, and Greptile rules that enforce it.
Audit & score history
The over-time audit spine: verify a persisted audit run, record the privacy-safe score to git, and render the score-over-time trend.
governance.config.yml
The per-repo governance dial: profile, stack, autonomy, adoption strictness, and the per-concern gate severities.
claims.yml
The grep/file/identity claims a repo must satisfy — the deterministic pins that keep load-bearing facts from eroding.