> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bevor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Finding commands

> Findings for the configured analysis.

<Note>The Bevor CLI is coming soon. This page previews its planned command interface.</Note>

Findings for the configured analysis.

## `bevor finding list`

List findings on the configured analysis, or search the team with `--all`.

```bash theme={null}
bevor finding list [OPTIONS]
```

| Parameter           | Type                                                                                                                                                                               | Required | Default | Description                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------- |
| `--all, -a`         | boolean                                                                                                                                                                            | No       | false   | Search findings across the team instead of the configured analysis (paginated). |
| `--page`            | integer                                                                                                                                                                            | No       | None    | Page number to query (--all only).                                              |
| `--page-size, -n`   | integer                                                                                                                                                                            | No       | None    | Results per page (--all only).                                                  |
| `--type`            | access\_control \| reentrancy \| arithmetic \| validation \| logic \| concurrency \| economic \| oracle \| denial\_of\_service \| upgradeability \| data\_exposure \| cryptography | No       | None    | Finding type.                                                                   |
| `--level`           | critical \| high \| medium \| low                                                                                                                                                  | No       | None    | Finding level.                                                                  |
| `--is-acknowledged` | boolean                                                                                                                                                                            | No       | None    | Filter by acknowledgement status.                                               |
| `--operation`       | add \| update \| delete                                                                                                                                                            | No       | None    | Staged draft operation.                                                         |
| `--created-by`      | string                                                                                                                                                                             | No       | None    | Created-by user id.                                                             |
| `--order-by`        | created\_at \| updated\_at \| level                                                                                                                                                | No       | None    | Sort field (--all only).                                                        |
| `--order`           | desc \| asc                                                                                                                                                                        | No       | None    | Sort order (--all only).                                                        |
| `--node`            | string                                                                                                                                                                             | No       | None    | Only findings tied to this graph node id.                                       |
| `--interactive, -i` | boolean                                                                                                                                                                            | No       | false   | Browse findings and expand the focused row.                                     |
| `--json, -j`        | boolean                                                                                                                                                                            | No       | false   | Output raw JSON.                                                                |
| `--sarif`           | path                                                                                                                                                                               | No       | None    | Write SARIF for the configured analysis to this path.                           |

## `bevor finding get`

```bash theme={null}
bevor finding get [OPTIONS] FINDING_ID
```

| Parameter    | Type    | Required | Default | Description      |
| ------------ | ------- | -------- | ------- | ---------------- |
| `FINDING_ID` | string  | Yes      | —       | Finding ID.      |
| `--json, -j` | boolean | No       | false   | Output raw JSON. |

## `bevor finding add`

Stage a new finding. `--file` is YAML; otherwise prompts interactively.

```bash theme={null}
bevor finding add [OPTIONS]
```

| Parameter           | Type                              | Required | Default | Description                                                      |
| ------------------- | --------------------------------- | -------- | ------- | ---------------------------------------------------------------- |
| `--version`         | string                            | No       | None    | Version id to stage against (default: configured analysis head). |
| `--file, -f`        | path                              | No       | None    | YAML file containing exactly one finding mapping.                |
| `--interactive, -i` | boolean                           | No       | false   | Force interactive prompts.                                       |
| `--type`            | string                            | No       | None    | —                                                                |
| `--level`           | critical \| high \| medium \| low | No       | None    | —                                                                |
| `--name`            | string                            | No       | None    | —                                                                |
| `--explanation`     | string                            | No       | None    | —                                                                |
| `--recommendation`  | string                            | No       | None    | —                                                                |
| `--reference`       | string                            | No       | None    | —                                                                |
| `--source`          | string                            | No       | None    | —                                                                |
| `--scope`           | string                            | No       | None    | —                                                                |
| `--location`        | string                            | No       | None    | —                                                                |
| `--uri`             | string                            | No       | None    | —                                                                |
| `--start-line`      | integer                           | No       | None    | —                                                                |
| `--start-column`    | integer                           | No       | None    | —                                                                |
| `--end-line`        | integer                           | No       | None    | —                                                                |
| `--end-column`      | integer                           | No       | None    | —                                                                |
| `--char-offset`     | integer                           | No       | None    | —                                                                |
| `--char-length`     | integer                           | No       | None    | —                                                                |
| `--byte-offset`     | integer                           | No       | None    | —                                                                |
| `--byte-length`     | integer                           | No       | None    | —                                                                |
| `--fqn`             | string                            | No       | None    | —                                                                |

## `bevor finding edit`

Stage an edit (`--file` YAML or interactive matching current metadata).

```bash theme={null}
bevor finding edit [OPTIONS] FINDING_ID
```

| Parameter    | Type   | Required | Default | Description                                                                                             |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `FINDING_ID` | string | Yes      | —       | Finding id to edit.                                                                                     |
| `--file, -f` | path   | No       | None    | YAML with one mapping: `type`, `level`, `name`, `description`; optional `recommendation` / `reference`. |

## `bevor finding delete`

Stage a finding deletion.

```bash theme={null}
bevor finding delete FINDING_ID
```

| Parameter    | Type   | Required | Default | Description           |
| ------------ | ------ | -------- | ------- | --------------------- |
| `FINDING_ID` | string | Yes      | —       | Finding id to delete. |

## `bevor finding revert`

Revert a staged finding change.

```bash theme={null}
bevor finding revert FINDING_ID
```

| Parameter    | Type   | Required | Default | Description           |
| ------------ | ------ | -------- | ------- | --------------------- |
| `FINDING_ID` | string | Yes      | —       | Finding id to revert. |

## `bevor finding acknowledge`

Toggle validation status for a finding.

```bash theme={null}
bevor finding acknowledge FINDING_ID
```

| Parameter    | Type   | Required | Default | Description                          |
| ------------ | ------ | -------- | ------- | ------------------------------------ |
| `FINDING_ID` | string | Yes      | —       | Finding id to toggle validation for. |
