1. Documentation
  2. How it works
  3. Audit lifecycle
ReadmeMarketplaceGitHub
  • Introduction
  • Quickstart
  • Supported providers
  • API-key providers
  • GitHub Copilot
  • OpenAI Codex
  • Amazon Bedrock
  • Action inputs
  • Reporting and severity
  • Audit lifecycle
  • Incremental audits
  • Safety boundaries
  • Troubleshooting

Audit lifecycle

How Heyo discovers, verifies, and publishes pull-request findings.

Loading documentation…

Reporting and severity< PreviousIncremental auditsNext >

Powered by heyo

On this page

1. Read the pull request2. Discover candidates3. Verify independently4. Publish current results

Heyo separates candidate discovery from verification so a single model response does not become a published review by itself.

1. Read the pull request

The Action reads GitHub pull-request metadata, the diff, changed paths, and bounded repository context. The collected diff is limited to 160 kB; an overflow is marked as truncated rather than failing before the audit begins.

2. Discover candidates

A Pi session reviews the changed code for the selected checks. The result is a set of structured candidate findings, not a public report.

3. Verify independently

With the default verification: true, Heyo starts a separate Pi session for each candidate. The verifier can inspect only the required bounded context and use a fixed git diff --check command. It must confirm the candidate before Heyo keeps it.

4. Publish current results

Immediately before writing, Heyo checks that the pull-request head did not change. A stale run publishes no Check, review comment, or incremental state. For a current head, verified findings are rendered according to the configured report mode.

Findings are about the pull request

Heyo annotates only changed lines. A verified issue outside the changed diff may be included in the Check summary but cannot become an inline comment.

Next steps

  • Learn how incremental audits handle later commits
  • Configure reporting and severity thresholds
  • Review Heyo's safety boundaries