Skip to main content

CLI: vyasa guard


Usage: vyasa guard [OPTIONS] COMMAND [ARGS]...

MD5 audit guard

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ audit Audit a session's changes against its baseline (out-of-scope = │
│ violation). │
│ expected Mark out-of-scope changes the developer approves as expected │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa guard audit


Usage: vyasa guard audit [OPTIONS]

Audit a session's changes against its baseline (out-of-scope = violation).

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --session -s TEXT Session ID to audit [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa guard expected


Usage: vyasa guard expected [OPTIONS] COMMAND [ARGS]...

Mark out-of-scope changes the developer approves as expected

┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ mark Mark an out-of-scope change as a developer-approved expected change. │
│ list List the developer-approved expected changes for a session. │
│ unmark Remove a developer-approved expected marker. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa guard expected mark


Usage: vyasa guard expected mark [OPTIONS] SESSION_ID

Mark an out-of-scope change as a developer-approved expected change.

The gate lists marked changes as developer-approved; the gate approver
must accept or reject them explicitly before the node advances.

┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --path -p TEXT Out-of-scope path (e.g. .claude/settings.json) │
│ [required] │
│ * --reason -r TEXT Why this change is expected [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa guard expected list


Usage: vyasa guard expected list [OPTIONS] SESSION_ID

List the developer-approved expected changes for a session.

┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa guard expected unmark


Usage: vyasa guard expected unmark [OPTIONS] SESSION_ID

Remove a developer-approved expected marker.

┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --path -p TEXT Path to unmark [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘