Security and data

Security and data, path by path.

Customer-CI execution, result sharing and controlled Fix have separate data paths. Source and sensitive observations stay local unless you approve a specific transfer.

your GitHub Actions runnerBracel check
  • your repository · summary, log, evidence file
  • Docker Hub · image pulled by digest
  • Profile-approved registries · dependency fetch only
  • Bracel · nothing

Where it runs

In your runner. Not on our servers.

In customer-CI mode, the check runs in your own GitHub Actions runner. No part of it runs on Bracel’s servers.

Every data path

Every transfer has a purpose and a boundary.

What leaves the runner, what it contains, and where it goes.

Customer-CI verification sends no telemetry by default. A connected workspace reads the approved GitHub check metadata; opt-in result transport uses a scoped payload tied to the repository, run, policy and commit. Detailed evidence export requires review and redaction. Fix previews outgoing file names, snippets and tool results before sharing with your selected model provider.

  1. Check summary and job log

    The report: rules, routes from your rules file, status codes, numbers, commit SHAs

    Your repository on GitHub

  2. Evidence file · opt-in

    The same fields as JSON

    A workflow artifact in your repository, kept 7 days, readable by whoever can read your Actions artifacts (anyone, for a public repository)

  3. Runtime image

    Nothing from you

    Pulled from Docker Hub, pinned by digest

  4. Dependency install

    Requests for the packages your lockfile names

    Only destinations approved by the execution profile; other destinations are refused

  5. Bracel

    Nothing. There is no telemetry.

    —

Execution contract

Controlled, and scoped.

In our tests on GitHub-hosted runners

  • The action sends no telemetry and no data to us.
  • It runs with a read-only GitHub token and needs no secrets.
  • Each language profile declares its dependency-fetch policy. Application and service fixtures use isolated networks, run-scoped storage and credentials, with bounded resources. No production secrets belong in a verification run.

The check summary and evidence file are built from an allowlist of fields, so they are designed not to contain your source code, application responses, application logs, or the values of configured headers and environment variables. Tests that planted marker strings in each of those found none. This rests on the allowlist and those tests, not on a formal proof.

Where the tool and the rules come from

Where the tool comes from

A pinned release you own.

From a pinned, versioned release with checksums, installed into a private repository you own and referenced by full commit SHA. It never comes from the pull request’s own checkout. Every result shows the commit and code digest of the release that ran.

Whose rules apply

Yours, from the base commit.

Rules and configuration are read from the pull request’s base commit, never from its head. A pull request that changes Bracel’s rules, code owners, or workflows gets UNKNOWN (policy-review-required), not a verdict. A rule takes effect only after it is merged into your base branch through your normal review.

What it protects against

Accidents, not adversaries with write access.

Every result carries the trust class customer-ci: it ran in your runner, and Bracel did not observe it.

Protects against

Accidental regressions in an approved rule, including ones introduced by AI coding tools.

Does not protect against

A contributor who modifies the workflow. Under the pull_request trigger, GitHub runs the workflow file from the pull request itself, so anyone who can change the workflow, the runner, or the job can change or fake the result.

Protect .github/workflows/ and the rules file with code owners. The workflow we provide does not use pull_request_target and gives pull request code no write-scoped secrets. Bracel changes no merge settings.

If Bracel gets it wrong

An incorrect PASS is a security issue.

We notify affected teams directly, ship a fixed release, and withdraw the affected rule template.

Report a vulnerability

security@bracel.dev

Including a suspected incorrect PASS. Please include the release version, what you observed, and steps to reproduce. Do not include production data or credentials.