avr-cli 0.7.0__py3-none-win_amd64.whl

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-repo-public-mirror.1

@@ -0,0 +1,36 @@
+.TH AVR\-REPO\-PUBLIC\-MIRROR 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-repo-public-mirror \- Request and browse mirrors of public GitHub repositories.
+.SH SYNOPSIS
+.B avr repo public-mirror
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Request and browse mirrors of public GitHub repositories.
+.PP
+.SH COMMANDS
+.TP
+cancel
+Cancel one pending public-mirror request.
+.TP
+check
+Check whether a public GitHub repository mirror is available.
+.TP
+request
+Request a mirror of a public GitHub repository.
+.TP
+requests
+List your organization's public-mirror requests.
+.TP
+view
+View one public-mirror request.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-repo (1),
+.BR avr-repo-clone (1),
+.BR avr-repo-list (1),
+.BR avr-repo-mirror (1),
+.BR avr-repo-public-mirror-cancel (1),
+.BR avr-repo-public-mirror-check (1),
+.BR avr-repo-public-mirror-request (1),
+.BR avr-repo-public-mirror-requests (1),
+.BR avr-repo-public-mirror-view (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-repo.1

@@ -0,0 +1,48 @@
+.TH AVR\-REPO 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-repo \- Manage repositories, git mirrors, and public mirrors.
+.SH SYNOPSIS
+.B avr repo
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+Manage repositories, git mirrors, and public mirrors.
+.PP
+.SH COMMANDS
+.TP
+clone
+Clone a repository from its nearest available Avrea mirror.
+.TP
+list
+List repositories you can access in an organization.
+.TP
+mirror
+Manage this repository's avrea-git mirror (feature-flagged).
+.TP
+public-mirror
+Request and browse mirrors of public GitHub repositories.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-artifact (1),
+.BR avr-status (1),
+.BR avr-run (1),
+.BR avr-pr (1),
+.BR avr-job (1),
+.BR avr-vm (1),
+.BR avr-workflow (1),
+.BR avr-cache (1),
+.BR avr-tests (1),
+.BR avr-sbom (1),
+.BR avr-log (1),
+.BR avr-auth (1),
+.BR avr-token (1),
+.BR avr-config (1),
+.BR avr-settings (1),
+.BR avr-firewall (1),
+.BR avr-billing (1),
+.BR avr-audit-events (1),
+.BR avr-org (1),
+.BR avr-health (1),
+.BR avr-repo-clone (1),
+.BR avr-repo-list (1),
+.BR avr-repo-mirror (1),
+.BR avr-repo-public-mirror (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-cancel.1

@@ -0,0 +1,38 @@
+.TH AVR\-RUN\-CANCEL 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-cancel \- Cancel an in-progress or queued workflow run.
+.SH SYNOPSIS
+.B avr run cancel
+[OPTIONS] RUN
+.SH DESCRIPTION
+Cancel an in-progress or queued workflow run.
+.PP
+RUN accepts the same Avrea IDs, GitHub run IDs, and run URLs as `avr run view`.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run cancel run-019e5a2e474e71c297e452279d4bcdea
+    avr run cancel run-019e5a2e474e71c297e452279d4bcdea --yes
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIRUN\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Skip the confirmation prompt.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-diagnose.1

@@ -0,0 +1,40 @@
+.TH AVR\-RUN\-DIAGNOSE 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-diagnose \- Explain a failed or unexpectedly slow workflow run.
+.SH SYNOPSIS
+.B avr run diagnose
+[OPTIONS] RUN
+.SH DESCRIPTION
+Explain a failed or unexpectedly slow workflow run.
+.PP
+RUN accepts the same Avrea IDs, GitHub run IDs, and run URLs as `avr run view`. A job URL selects that job's attempt; the report still covers the whole attempt. The report combines jobs and failed steps, bounded failed-job log tails, queue/execution timings, runner metrics, and a prior-success workflow baseline.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run diagnose run-019e5a2e474e71c297e452279d4bcdea
+    avr run diagnose 123456789 --json
+    avr run diagnose https://github.com/acme/widgets/actions/runs/123456789
+    avr run diagnose https://github.com/acme/widgets/actions/runs/123456789/job/987654321
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIRUN\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-json\fR
+Output the diagnostic report as JSON.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-list.1

@@ -0,0 +1,86 @@
+.TH AVR\-RUN\-LIST 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-list \- List workflow runs for an organization.
+.SH SYNOPSIS
+.B avr run list
+[OPTIONS]
+.SH DESCRIPTION
+List workflow runs for an organization.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run list
+    avr run list --status failure --limit 5
+    avr run list --status in_progress --json status,conclusion,head_branch
+    avr run list --branch main --status completed
+    avr run list --since 24h
+    avr run list --json '?'           # list available fields
+    avr run list --json '*'           # all fields
+    avr run list --json status,conclusion -q '[.[] | select(.status == "completed")]'
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    ci_provider, workflow_name, workflow_path, conclusion, created_at, display_title, duration_seconds, event,
+    head_branch, head_sha, platform_run_id, repository, run_attempt, run_id,
+    run_number, status, triggering_actor, updated_at, workflow, workflow_id
+.fi
+.RE
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Filter by repository (org/repo or rep-xxx). Pass --repo more than once to filter multiple repositories. Auto-detected from git remote if omitted. (repeatable)
+.TP
+\fB\-\-status\fR \fICHOICE\fR
+Filter by state (queued, in_progress, completed) or conclusion (success, failure, ...). Repeatable. (choices: action_required, cancelled, completed, failure, in_progress, neutral, queued, skipped, stale, startup_failure, success, timed_out; repeatable)
+.TP
+\fB\-\-branch\fR \fITEXT\fR
+Filter by head branch (repeatable). (repeatable)
+.TP
+\fB\-\-ci\-provider\fR \fICHOICE\fR
+Filter by CI engine. (choices: github_actions, gitlab_ci, avrea_ci)
+.TP
+\fB\-w\fR, \fB\-\-workflow\fR \fITEXT\fR
+Filter by workflow ID (wfl- or awf-, repeatable). (repeatable)
+.TP
+\fB\-\-since\fR \fITEXT\fR
+Relative time window: '7d', '24h', etc. Sugar for --created-after.
+.TP
+\fB\-\-from\fR, \fB\-\-created\-after\fR \fITEXT\fR
+Only runs created after this ISO timestamp.
+.TP
+\fB\-\-to\fR, \fB\-\-created\-before\fR \fITEXT\fR
+Only runs created before this ISO timestamp.
+.TP
+\fB\-L\fR, \fB\-\-limit\fR \fIINTEGER RANGE\fR
+Max runs to return. (default: 20)
+.TP
+\fB\-\-cursor\fR \fITEXT\fR
+Pagination cursor from a previous response.
+.TP
+\fB\-\-order\fR \fICHOICE\fR
+Sort order. (choices: created_at.desc, created_at.asc; default: created_at.desc)
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.TP
+\fB\-\-web\fR
+Open in browser.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-logs.1

@@ -0,0 +1,55 @@
+.TH AVR\-RUN\-LOGS 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-logs \- Fetch logs for a workflow run's jobs.
+.SH SYNOPSIS
+.B avr run logs
+[OPTIONS] RUN
+.SH DESCRIPTION
+Fetch logs for a workflow run's jobs.
+.PP
+RUN accepts the same Avrea IDs, GitHub run IDs, and run URLs as `avr run view`. A GitHub job URL shows only that job's logs.
+.PP
+Long-form alternative to `avr run view --log[-failed]`. Use --follow to tail logs in real time for an in-progress job; pass --job to scope to a specific job when a run has many.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run logs run-019e5a2e474e71c297e452279d4bcdea
+    avr run logs run-019e5a2e474e71c297e452279d4bcdea --failed
+    avr run logs run-019e5a2e474e71c297e452279d4bcdea --job test
+    avr run logs run-019e5a2e474e71c297e452279d4bcdea --follow
+    avr run logs https://github.com/acme/widgets/actions/runs/123456789/job/987654321
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIRUN\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-job\fR \fITEXT\fR
+Restrict to GitHub jobs whose name contains this string.
+.TP
+\fB\-f\fR, \fB\-\-follow\fR
+Tail logs as they appear (running jobs only).
+.TP
+\fB\-\-failed\fR
+Show only logs from failed jobs.
+.TP
+\fB\-\-all\-levels\fR
+Include diagnostic-level lines (off by default).
+.TP
+\fB\-\-no\-pager\fR
+Print directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-rerun.1

@@ -0,0 +1,51 @@
+.TH AVR\-RUN\-RERUN 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-rerun \- Re-run a completed workflow run.
+.SH SYNOPSIS
+.B avr run rerun
+[OPTIONS] RUN
+.SH DESCRIPTION
+Re-run a completed workflow run.
+.PP
+RUN accepts the same Avrea IDs, GitHub run IDs, and run URLs as `avr run view`.
+.PP
+Avrea CI keeps the original revision. Use --failed for failed/cancelled jobs or repeat --job for selected jobs. Their downstream dependents also rerun; other results are retained. The new attempt can be watched immediately.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run rerun run-019e5a2e474e71c297e452279d4bcdea
+    avr run rerun run-019e5a2e474e71c297e452279d4bcdea --failed
+    avr run rerun run-019e5a2e474e71c297e452279d4bcdea --yes
+    avr run rerun awr-019e5a2e474e71c297e452279d4bcdea --job build --job test
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+\fIRUN\fR
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-failed\fR
+Re-run failed jobs and dependents; includes cancelled jobs for Avrea CI.
+.TP
+\fB\-\-job\fR \fITEXT\fR
+Avrea job name or ID to rerun with dependents; repeat for multiple jobs. (repeatable)
+.TP
+\fB\-\-idempotency\-key\fR \fIUUID\fR
+Reuse a previous Avrea CI rerun request UUID.
+.TP
+\fB\-y\fR, \fB\-\-yes\fR
+Skip the confirmation prompt.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-view.1

@@ -0,0 +1,83 @@
+.TH AVR\-RUN\-VIEW 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-view \- View a workflow run with its jobs.
+.SH SYNOPSIS
+.B avr run view
+[OPTIONS] [RUN]
+.SH DESCRIPTION
+View a workflow run with its jobs.
+.PP
+.RS 4
+.nf
+RUN accepts an Avrea run ID, a positive GitHub run ID, a GitHub Actions
+run or job URL, or an Avrea console run URL. A job URL opens the attempt
+that job belongs to. Without RUN, shows 10 most recent runs.
+.fi
+.RE
+.PP
+.RS 4
+.nf
+Examples:
+    avr run view
+    avr run view run-019e5a2e474e71c297e452279d4bcdea
+    avr run view 123456789
+    avr run view https://github.com/acme/widgets/actions/runs/123456789
+    avr run view https://github.com/acme/widgets/actions/runs/123456789/job/987654321
+    avr run view run-019e5a2e474e71c297e452279d4bcdea --steps
+    avr run view run-019e5a2e474e71c297e452279d4bcdea --log-failed
+    avr run view run-019e5a2e474e71c297e452279d4bcdea --job Build
+    avr run view run-019e5a2e474e71c297e452279d4bcdea --json conclusion,jobs
+    avr run view run-019e5a2e474e71c297e452279d4bcdea --json '*' --jq '.jobs[].job_name'
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    ci_provider, workflow_name, workflow_path, conclusion, created_at, display_title, duration_seconds, event,
+    head_branch, head_sha, jobs, platform_run_id, repository, run_attempt,
+    run_id, run_number, status, triggering_actor, updated_at, workflow,
+    workflow_id
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+[\fIRUN\fR]
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-steps\fR
+Expand each job to show its individual steps.
+.TP
+\fB\-\-log\fR
+Print full logs for all jobs.
+.TP
+\fB\-\-log\-failed\fR
+Print logs only for failed steps.
+.TP
+\fB\-\-job\fR \fITEXT\fR
+Restrict view and logs to jobs whose name contains this string.
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.TP
+\fB\-\-web\fR
+Open in browser.
+.TP
+\fB\-\-no\-pager\fR
+Print logs directly to stdout instead of paging through `less`. Same as setting AVR_PAGER=''.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run-watch.1

@@ -0,0 +1,58 @@
+.TH AVR\-RUN\-WATCH 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run-watch \- Watch a workflow run until it completes.
+.SH SYNOPSIS
+.B avr run watch
+[OPTIONS] [RUN]
+.SH DESCRIPTION
+Watch a workflow run until it completes.
+.PP
+.RS 4
+.nf
+RUN accepts the same Avrea IDs, GitHub run IDs, and run URLs as
+`avr run view`. Without RUN, auto-selects the latest in-progress run.
+Pass --repo (repeatable) to scope the auto-select to specific repositories.
+.fi
+.RE
+.PP
+NDJSON job and run completion events include ci_provider (github_actions, gitlab_ci, or avrea_ci). Native jobs have a null platform_job_id; correlate events using run_id and avrea_job_id.
+.PP
+.RS 4
+.nf
+Examples:
+    avr run watch
+    avr run watch --repo acme/web
+    avr run watch --repo a/x --repo b/y
+    avr run watch run-019e5a2e474e71c297e452279d4bcdea --exit-status
+    avr run watch run-019e5a2e474e71c297e452279d4bcdea --ndjson | jq -c .
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+[\fIRUN\fR]
+\&
+.SH OPTIONS
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug.
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Scope the auto-select to a repo (org/name or rep-xxx, repeatable). Auto-detected from git remote if omitted. (repeatable)
+.TP
+\fB\-\-exit\-status\fR
+Exit non-zero if run failed.
+.TP
+\fB\-\-interval\fR \fIINTEGER\fR
+Refresh interval in seconds. (default: 3)
+.TP
+\fB\-\-ndjson\fR
+Force NDJSON event stream (default when stdout isn't a TTY).
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-run (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-run.1

@@ -0,0 +1,60 @@
+.TH AVR\-RUN 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-run \- View and manage CI workflow runs.
+.SH SYNOPSIS
+.B avr run
+[OPTIONS] COMMAND [ARGS]...
+.SH DESCRIPTION
+View and manage CI workflow runs.
+.PP
+.SH COMMANDS
+.TP
+cancel
+Cancel an in-progress or queued workflow run.
+.TP
+diagnose
+Explain a failed or unexpectedly slow workflow run.
+.TP
+list
+List workflow runs for an organization.
+.TP
+logs
+Fetch logs for a workflow run's jobs.
+.TP
+rerun
+Re-run a completed workflow run.
+.TP
+view
+View a workflow run with its jobs.
+.TP
+watch
+Watch a workflow run until it completes.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-artifact (1),
+.BR avr-status (1),
+.BR avr-pr (1),
+.BR avr-job (1),
+.BR avr-vm (1),
+.BR avr-workflow (1),
+.BR avr-cache (1),
+.BR avr-tests (1),
+.BR avr-sbom (1),
+.BR avr-log (1),
+.BR avr-auth (1),
+.BR avr-token (1),
+.BR avr-config (1),
+.BR avr-settings (1),
+.BR avr-firewall (1),
+.BR avr-billing (1),
+.BR avr-audit-events (1),
+.BR avr-repo (1),
+.BR avr-org (1),
+.BR avr-health (1),
+.BR avr-run-cancel (1),
+.BR avr-run-diagnose (1),
+.BR avr-run-list (1),
+.BR avr-run-logs (1),
+.BR avr-run-rerun (1),
+.BR avr-run-view (1),
+.BR avr-run-watch (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-sbom-download.1

@@ -0,0 +1,45 @@
+.TH AVR\-SBOM\-DOWNLOAD 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-sbom-download \- Download an SBOM artifact (CycloneDX, SPDX, or dependency inventory).
+.SH SYNOPSIS
+.B avr sbom download
+[OPTIONS] [COMMIT]
+.SH DESCRIPTION
+Download an SBOM artifact (CycloneDX, SPDX, or dependency inventory).
+.PP
+COMMIT is the commit of a recorded SBOM, as a full SHA or a unique prefix of at least 7 characters such as the one `avr sbom list` shows. Defaults to the latest SBOM.
+.PP
+.RS 4
+.nf
+Examples:
+    avr sbom download --repo acme/api
+    avr sbom download --repo acme/api --format spdx --out api.spdx.json
+    avr sbom download 3f2c9a1b7d04 --repo acme/api --out - | jq .components
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+[\fICOMMIT\fR]
+\&
+.SH OPTIONS
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted.
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-commit\fR \fITEXT\fR
+Same as the COMMIT argument.
+.TP
+\fB\-\-format\fR \fICHOICE\fR
+Artifact to download. (choices: cyclonedx, inventory, spdx; default: cyclonedx)
+.TP
+\fB\-\-out\fR \fITEXT\fR
+Output file path, or "-" for stdout. Defaults to the artifact filename in the current directory.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-sbom (1),
+.BR avr-sbom-generate (1),
+.BR avr-sbom-list (1),
+.BR avr-sbom-view (1)

avr_cli-0.7.0.data/data/share/avr/man/man1/avr-sbom-generate.1

@@ -0,0 +1,62 @@
+.TH AVR\-SBOM\-GENERATE 1 "" "avr 0.7.0" "Avrea CLI"
+.SH NAME
+avr-sbom-generate \- Start SBOM generation for a repository.
+.SH SYNOPSIS
+.B avr sbom generate
+[OPTIONS] [REF]
+.SH DESCRIPTION
+Start SBOM generation for a repository.
+.PP
+REF is the branch, tag, or commit SHA to analyse; an abbreviated SHA such as the one `avr sbom list` shows works too. Defaults to the default-branch tip. Without --wait, commit_sha is the full SHA of the commit the run analyses when REF is a full SHA or one the API expanded.
+.PP
+One analysis runs per repository at a time. A request for the same ref as the analysis already running joins it; a request for a different ref is rejected (HTTP 409) until that analysis finishes. Once an SBOM has been recorded for the repository, a new run is refused (HTTP 429) for a cooldown period, and the error says how many seconds remain.
+.PP
+With --wait and a REF that names a commit, success means a new SBOM for that commit is downloadable, whatever the analysis task's own outcome (task_status); commit_sha and recorded_at identify it. A failed analysis can still deliver its SBOM later, so such a wait runs to --wait-timeout before reporting failure. For a branch, tag, or the default branch the API does not say which commit the run resolved, so --wait reports the analysis task's outcome only. Transient errors while waiting are retried until --wait-timeout; a wait that times out leaves the analysis running.
+.PP
+.RS 4
+.nf
+Examples:
+    avr sbom generate --repo acme/api
+    avr sbom generate v1.4.0 --repo acme/api
+    avr sbom generate 3f2c9a1b7d04 --repo acme/api --wait
+.fi
+.RE
+.PP
+.RS 4
+.nf
+JSON FIELDS
+    ai_task_id, commit_sha, error_code, recorded_at, status, task_status
+.fi
+.RE
+.SH ARGUMENTS
+.TP
+[\fIREF\fR]
+\&
+.SH OPTIONS
+.TP
+\fB\-\-repo\fR \fITEXT\fR
+Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted.
+.TP
+\fB\-\-org\fR \fITEXT\fR
+Organization ID or slug. Uses default org if not specified (see: avr config set org).
+.TP
+\fB\-\-ref\fR \fITEXT\fR
+Same as the REF argument.
+.TP
+\fB\-\-wait\fR
+Wait until generation finishes before returning.
+.TP
+\fB\-\-wait\-timeout\fR \fIINTEGER RANGE\fR
+Seconds to wait when --wait is set. (default: 900)
+.TP
+\fB\-\-json\fR \fITEXT\fR
+Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
+.TP
+\fB\-q\fR, \fB\-\-jq\fR \fITEXT\fR
+Filter --json output through a jq expression.
+.SH SEE ALSO
+.BR avr (1),
+.BR avr-sbom (1),
+.BR avr-sbom-download (1),
+.BR avr-sbom-list (1),
+.BR avr-sbom-view (1)