Skip to content
/ docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Concepts

The terms Tripwire uses to describe what it checks and what happens next.

When a pull request opens, Tripwire can run a set of checks, take an action, and record the result. The same terms apply in the dashboard, the CLI, and the agent tools.

Term Meaning
Forge The service that hosts the repository, such as GitHub.
Rule A condition Tripwire evaluates, such as whether a pull request changes at most 100 files.
Gate Logic that combines check results. An All of gate passes when every connected check passes.
Repository gate The repository setting that turns Tripwire checks on or off.
Trigger The event or schedule that starts a workflow.
Workflow A composition of rules that starts on a trigger and uses gates and actions to decide what happens next.
Action What Tripwire does after a step, such as adding a label or blocking a pull request.
Run The record of what Tripwire evaluated and did for one event. Find it in Activity.
Verdict The outcome recorded for the run.
Human review The queue for pull requests waiting on a maintainer’s decision.

Signals

A signal is a value a rule can check. Tripwire gets signals from the forge’s event data and API, and calculates some from that data. For example, GitHub provides the changed-file count for a pull request. Tripwire calculates account age from the account’s creation date.

A rule compares a signal with a condition. In “files changed is at most 100,” the signal is the file count, the comparison is “at most,” and the limit is 100.

Check results

Result Meaning
Pass The condition was met.
Fail Tripwire evaluated the condition and found that it did not pass.
Skipped The check produced neither a pass nor a fail, for example because the forge did not provide the evidence.

A rule produces a check result. The workflow uses that result to choose what happens next. See how workflow branches work.

Was this page helpful?