CLI: vyasa gate
Usage: vyasa gate [OPTIONS] COMMAND [ARGS]...
List, run, approve, and reject gates
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ list List gates defined in the workflow. Use --node to filter by node's │
│ current transition. │
│ run Validate ALL gates for a node's current transition. Reports │
│ pass/fail per gate. No status change. │
│ approve Validate ALL gates for a node's current transition and advance │
│ status if all pass. │
│ reject Reject a node — roll back applied content via snapshot, change │
│ status. │
│ obsolete Mark a node as obsolete (terminal `reject` status) — roll back │
│ applied content. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa gate list
Usage: vyasa gate list [OPTIONS]
List gates defined in the workflow. Use --node to filter by node's current
transition.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --node TEXT Node ID to show gates for │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa gate run
Usage: vyasa gate run [OPTIONS]
Validate ALL gates for a node's current transition. Reports pass/fail per
gate. No status change.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --node TEXT Node ID to validate [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa gate approve
Usage: vyasa gate approve [OPTIONS]
Validate ALL gates for a node's current transition and advance status if all
pass.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --node TEXT Node ID to approve [required] │
│ --reason -r TEXT Approval reason │
│ --accept-guard Accept the developer-marked expected │
│ out-of-scope changes │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa gate reject
Usage: vyasa gate reject [OPTIONS]
Reject a node — roll back applied content via snapshot, change status.
The applied files are restored to their pre-apply state from the latest
snapshot. The post-apply versions are archived to
`.vyasa/archive/applied/{node_id}-{ts}/`. The node's status changes
per the transition's `on_fail_status` (or `from_status` fallback).
To resume the proposer session, use `vyasa apply reject` (pre-apply).
To mark a node as TERMINAL obsolete, use `vyasa gate obsolete`.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --node TEXT Node ID to reject [required] │
│ --reason -r TEXT Rejection reason │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa gate obsolete
Usage: vyasa gate obsolete [OPTIONS]
Mark a node as obsolete (terminal `reject` status) — roll back applied
content.
Distinct from `vyasa gate reject`:
- `vyasa gate reject` lands at `on_fail_status` (typically `draft`,
so the node can be reworked in a new session).
- `vyasa gate obsolete` lands at terminal `reject` status — the node
is permanently marked as obsolete, no new sessions can start.
The applied files are restored to their pre-apply state from the
latest snapshot. The post-apply versions are archived to
`.vyasa/archive/applied/{node_id}-{ts}/`. The node's status is set
to `reject` (terminal). Use `vyasa node supersede` to link the
obsolete node to a successor.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --node TEXT Node ID to mark as obsolete [required] │
│ --reason -r TEXT Rejection reason │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘