vitna.ai/docs/cli/overview Machine view
Raw .md llms.txt
> Source: https://vitna.ai/docs/cli/overview
> Raw Markdown: https://vitna.ai/docs/cli/overview.md
> Corpus index: https://vitna.ai/llms.txt

# The CLI

Everything an operator does to the record is a command, run from a checkout with
the environment sourced. There is no admin UI, and that is a property of the
design rather than a gap.

## Why the record is operated and not administered

Every write that changes what the record says is an act with a person behind it,
made through a role that holds the privilege. Every `UPDATE` grant in this
database is column-level and there are two in `aperture`: the collector marks a
trigger fired, and the console records a ruling on a decision. Neither
`witness` nor `aperture` grants `DELETE` at all.

So there is no endpoint that could quietly accept a decision. The one endpoint
that accepts one is `/console/rule`, it does nothing quietly, and it cannot
touch a decision's outcome, thresholds, inputs, reason or brief, because those
columns are not in its grant. Everything else about the register is entered at
a prompt, as the owning role, which is what the rest of this page is.

## The families

| Family | Count | What it touches |
|---|---|---|
| [`witness:*`](witness/seed.md) | 5 | The record: seeding, collecting, replaying, signing, publishing rates |
| [`event:add`](event-add.md) | 1 | The market log |
| [`sku:*`](skus/candidates.md) | 4 | The discovery queue |
| [`aperture:*`](aperture/workloads.md) | 24 | Workloads, evidence, triggers, decisions, compound pipelines, audit packs, fallback chains and rules |
| [`org:*`, `auth:*`](access.md) | 4 | Which orgs exist and who may read `/console` |
| [`org:key:*`](keys.md) | 2 | Who may land a reading over the network |
| [`db:*`](database.md) | 2 | Migrations |
| [`scripts/`](scripts.md) | 5 | Mirrors and tooling |

## Shared conventions

**A dry run writes nothing.** `--dry-run` where offered, and several commands
report rather than write unless given `--yes`.

**A verify recomputes.** `--verify` on the signing and rate commands recomputes
every row ever published and reports disagreement rather than trusting.

**Refusals name the row.** A command that cannot do what it was asked says which
input it refused and why, rather than doing part of the job.

**Nothing invents data.** A command with a missing credential or an unreachable
source fails and says so. It does not fall back to a plausible number.
Human Machine Shift+M