consensus-tools audit

Summarize recent guard decisions with filtering by date, domain, and outcome.

Usage

consensus-tools audit [--since <date>] [--domain <domain>] [--decision <decision>] [--limit <n>] [--json]

audit queries the board's audit log and renders a summary table of recent guard decisions. Use it to review what your guards have been doing, spot patterns, or investigate incidents.

Options

Option	Default	Description
`--since <date>`	Last 7 days	ISO 8601 date — only include events on or after this date
`--domain <domain>`	All domains	Filter by guard domain (e.g. `code_merge`, `send_email`)
`--decision <decision>`	All outcomes	Filter by outcome: `ALLOW`, `BLOCK`, `REWRITE`, `REQUIRE_HUMAN`
`--limit <n>`	50	Maximum number of events to return
`--json`	—	Output raw JSON instead of a table

Examples

# Show all decisions from the past week
consensus-tools audit

# Show only blocked code merges since March 1
consensus-tools audit --since 2026-03-01 --domain code_merge --decision BLOCK

# Last 20 decisions across all domains, JSON output
consensus-tools audit --limit 20 --json

Example output

┌───────────────┬──────────────┬──────────────┬────────────┬────────────────────┐
│ Audit ID      │ Domain       │ Decision     │ Confidence │ Timestamp          │
├───────────────┼──────────────┼──────────────┼────────────┼────────────────────┤
│ audit_abc123  │ code_merge   │ BLOCK        │ 0.92       │ 2026-03-15 14:22   │
│ audit_def456  │ send_email   │ ALLOW        │ 0.87       │ 2026-03-15 13:10   │
│ audit_ghi789  │ deployment   │ REQUIRE_HUMAN│ 0.61       │ 2026-03-15 11:05   │
└───────────────┴──────────────┴──────────────┴────────────┴────────────────────┘

Use the Audit ID from any row with consensus-tools explain to get the full narrative.

Guard domains

Domain	Guard
`code_merge`	PR/branch merge governance
`send_email`	Outbound email governance
`deployment`	Release deployment governance
`support_reply`	Customer support reply governance
`agent_action`	Autonomous agent action governance
`permission_escalation`	IAM/privilege escalation governance
`publish`	Content publishing governance

explain — generate a plain-language narrative for a specific audit event
CLI Reference — all available commands
Core: summarizeGuardActivity — programmatic equivalent via @consensus-tools/core

Previous←explain NextOverview→

Usage

Options

Examples

Example output

Guard domains

Related