Skip to main content

TrustRelay

Delegate Merge Authority Safely

TrustRelay sits at the merge boundary and independently authorizes every agent-authored change before it merges.

  1. Observe

    A pull request authored by an agent is detected at the merge boundary.

  2. Assemble evidence

    Attribution, human sponsorship, policy context, and check results are gathered into a versioned evidence snapshot.

  3. Decide

    Deterministic policy is applied to the evidence to issue approve, block, or escalate. No AI makes or modifies the decision.

  4. Sign the record

    The decision is written as a signed, independently verifiable Agent Change Passport.

  5. Enforce

    The signed decision is published as a required check that governs whether the change may merge.

Every stage is deterministic and independently verifiable. No AI makes or modifies the authorization decision.

What the product actually produces

TrustRelay surfaces as a required check on the pull request, a signed decision record that outlives it, and a command that puts the flow in place. These are the real artefacts, not mockups of a future release.

Blocked

TrustRelay authorization

Agent-authored change without a human sponsor recorded.

To proceed: Assign a sponsor, then re-run the check.

Approved

Agent Change Passport

Reason
Low-risk change, required evidence present, policy version pinned.
Evidence considered
  • agent-attribution: copilot/session-4f21
  • human-sponsor: platform-eng/rivera
  • policy: standard-application-change@v12
  • checks: build, tests, secret-scan — all passed
Signature
kms:9f3c…c41aKMS-signed and independently verifiable without TrustRelay API access.
  1. Observe
  2. Assemble evidence
  3. Decide
  4. Sign the record
  5. Enforce
The five stages of an authorization decision, in order. Every stage is deterministic and independently verifiable.
npx @trust-relay/trctl init --repo acme/api

Numbers you can check

No pilot has run yet, so there are no customer metrics to report and we will not invent any. What is verifiable today is the engineering: each figure below was counted from the codebase, and the file that establishes it is named under the number.

rules evaluated for every change
5

Basis Decision engine source — decision-engine/src/engine/decision-engine.ts

stable reason codes a decision can report
16

Basis Reason-code registry — decision-engine/src/engine/reason-codes.ts

byte-identical replays asserted in the determinism test
1,000

Basis Replay suite — decision-engine/tests/e2e/replay.test.ts

operating modes: shadow, advisory, limited enforcement
3

Basis Domain types — domain-types/src/entities/policy.ts

Design partners

Reserved for design-partner logos — none are published yet

Five questions no one can answer at merge time

When an agent contributes to a pull request, the merge decision depends on five questions that most engineering organizations cannot answer with confidence.

  1. Who or what produced this change?

    Was it a human, an agent, or a mix? Current tools cannot reliably distinguish agent-authored from human-authored code across multiple coding agents.

  2. Which human authorized this work?

    Is there a designated sponsor? Without a binding between the agent's work and an accountable human, there is no one to answer for the change.

  3. What evidence exists that this is safe?

    Has it passed the required checks, reviews, and compliance gates? Evidence is scattered across CI/CD, security scanners, and manual review — none of it connected to the authorization decision.

  4. Which policy governed this decision?

    Was the same policy applied consistently? Without a versioned policy binding, the same change can be evaluated differently depending on when and how it is reviewed.

  5. What happened after this change was released?

    Did it succeed, fail, or get reverted? A merge decision disconnected from the production outcome cannot be learned from.

Blocked

TrustRelay authorization

No human sponsor recorded for this agent-authored change. The required check cannot pass.

To proceed: Assign a sponsor, then re-run the check.

Independent authorization

TrustRelay is a neutral authorization layer between coding agents and the merge button. It observes every agent-authored change, assembles a verifiable evidence snapshot, applies your policy deterministically, and publishes an enforceable decision before anything merges.

It is not a coding agent, a source-code host, or a CI/CD platform. No AI makes or modifies an authorization decision.

  1. Observe

    A pull request authored by an agent is detected at the merge boundary.

  2. Assemble evidence

    Attribution, human sponsorship, policy context, and check results are gathered into a versioned evidence snapshot.

  3. Decide

    Deterministic policy is applied to the evidence to issue approve, block, or escalate. No AI makes or modifies the decision.

  4. Sign the record

    The decision is written as a signed, independently verifiable Agent Change Passport.

  5. Enforce

    The signed decision is published as a required check that governs whether the change may merge.

Every stage is deterministic and independently verifiable. No AI makes or modifies the authorization decision.

How TrustRelay works

Every agent-authored change follows the same five-stage path, from the moment it is observed to the moment it is enforced. The decision is deterministic at every stage.

  1. Observe

    A pull request authored by an agent is detected at the merge boundary.

  2. Assemble evidence

    Attribution, human sponsorship, policy context, and check results are gathered into a versioned evidence snapshot.

  3. Decide

    Deterministic policy is applied to the evidence to issue approve, block, or escalate. No AI makes or modifies the decision.

  4. Sign the record

    The decision is written as a signed, independently verifiable Agent Change Passport.

  5. Enforce

    The signed decision is published as a required check that governs whether the change may merge.

What makes the decision trustworthy

Six properties of the authorization layer. Each one exists so that a decision can be reproduced, explained, and enforced.

Deterministic policy engine

A pure function with zero runtime dependencies on network, database, or model SDKs. Given the same evidence and policy, the result is always the same.

  • The same evidence and policy always produce the same outcome.
  • Runs with no network, database, or model access.
  • Every decision carries a stable, documented reason code.

Agent Change Passport

A KMS-signed, versioned artefact capturing policy version, evidence snapshot, attribution assertions, and outcome.

Immutable evidence ledger

Every passport is stored with WORM protection. Evidence cannot be altered after the fact.

GitHub required check

If the check fails, branch protection prevents merge. Enforcement is architectural, not procedural.

Restrictive precedence

BLOCK > ESCALATE > APPROVE. If any rule blocks, the decision is BLOCK regardless of the others.

Bounded AI assertions

AI may propose typed assertions. Invalid or conflicting ones become UNKNOWN and can never produce automatic approval.

Designed for security and auditability

TrustRelay is a polyrepo distributed system on AWS. Each service is independently deployable with its own CI/CD pipeline, and the decision engine has no runtime dependency on the network, a database, or a model SDK.

  1. Trigger layer

    Detect the change

  2. Evidence pipeline

    Assemble the inputs

  3. Decision engine

    Decide deterministically

  4. Passport service

    Sign and retain

  5. Enforcement

    Govern the merge

Works where your team works

Every integration is either an evidence source that strengthens the decision or an enforcement point that carries it out.

GitHub

Enforcement point

Required checks, rulesets, and branch protection at the merge boundary. This is where a decision is carried out.

GitHub Copilot

Evidence source

Agent session metadata, attribution signals, and code provenance.

Jira

Evidence source

Work-item context and assignee records that bind a change to its intent.

GitHub Actions

Evidence source

Check results and pipeline status, gathered into the evidence snapshot.

What we guarantee, and what we do not

No AI makes or modifies an authorization decision.

The decision is made by a deterministic engine that has no runtime dependency on a network, a database, or a model SDK. AI may propose typed assertions; it never makes or modifies the decision, and an architecture test fails the build if a model dependency is introduced into the engine.

Limitations

  • A verified record proves integrity, not correctness

    Verifying a decision record proves the bytes are unaltered and were signed by the key you supplied. It does not prove the evidence was complete, that the policy was right, or that the decision was the correct one.

  • Attribution is not always knowable

    When every commit has unknown attribution, the engine escalates to human review rather than approving. The product cannot always establish which agent produced a change, and it does not pretend to.

  • Shadow mode reports but does not block

    In shadow mode the check never reports success or failure — it is neutral or action-required — and merge eligibility is unaffected. Enforcement begins only when you enable it.

  • The engine applies your policy; it does not author it

    TrustRelay evaluates evidence against the policy you pin to a repository. It does not decide whether that policy is appropriate, and a wrong policy applied consistently is wrong at scale.

Ready to delegate merge authority?

Start in shadow mode and see the decision TrustRelay would have issued for your last hundred agent-authored changes.