Skip to content

Findings CLI

Use provon findings to inspect persisted Findings, record review decisions, create external repair work items, and manage diagnostic rules.

View as Markdown Open the plain-text version of this page.

This is different from provon diagnose, which analyzes local evidence without persisting a Finding.

List Findings#

bash
provon findings list
provon findings list --review-status unreviewed --min-score 0.7 --limit 50

Time filters accept Unix timestamps in milliseconds:

bash
provon findings list \
  --last-detected-after 1755216000000 \
  --last-detected-before 1755302400000

Inspect Evidence#

bash
provon findings get <finding-id>

The response includes the Finding, evidence references, occurrence data, and current external work item when one exists.

Record A Review#

Update review and resolution in separate commands:

bash
provon findings update <finding-id> --review-status confirmed
provon findings update <finding-id> --review-status dismissed
provon findings update <finding-id> --resolution-status resolved

Supported review states are unreviewed, confirmed, and dismissed. Resolution states are resolved and unresolved.

Hand Off A Repair#

Create a work item through a configured provider:

bash
provon findings handoff <finding-id> \
  --provider github \
  --destination owner=provon \
  --destination repo=provon

Supported providers are github, gitlab, linear, and jira. Destination fields depend on the provider and may be omitted when the connector has defaults.

Manage Work Items#

List work items linked to a Finding:

bash
provon findings work-items list <finding-id>

Inspect, sync, retry, replace, or abandon a work item:

bash
provon findings work-items get <finding-id> <work-item-id>
provon findings work-items sync <finding-id> <work-item-id>
provon findings work-items retry <finding-id> <work-item-id>
provon findings work-items replace <finding-id> <work-item-id> \
  --provider linear \
  --destination team=ENG
provon findings work-items abandon <finding-id> <work-item-id>

Discover And Analyze#

Run diagnostics on the most recent project conversations:

bash
provon findings discover

Enqueue diagnostic analysis for a specific conversation:

bash
provon findings analyze <conversation-id>
provon findings analyze <conversation-id> --trace-id <trace-id> --trace-id <trace-id>

Manage Diagnostic Rules#

List and inspect rules:

bash
provon findings rules list
provon findings rules get <rule-id>

Enable or disable a rule:

bash
provon findings rules enable <rule-id>
provon findings rules disable <rule-id>

Update rule configuration:

bash
provon findings rules configure <rule-id> '{"minSignalScore":0.5}'

Run a rule over historical conversations:

bash
provon findings rules backfill <rule-id> \
  --start 1755216000000 \
  --end 1755302400000 \
  --max-conversations 1000

Diagnostic Settings#

Show or update automatic diagnostic scheduling:

bash
provon findings settings get
provon findings settings set-scheduling true
provon findings settings set-scheduling false