ForgeOSby Medina19
Sign in Create account

Trust

ForgeOS acts only inside authority you granted, and it records what it did.

This page describes controls the software actually enforces. Where something is a commitment rather than an enforced control, or has not been published yet, it says so.

The authority model

Every consequential capability is a separate grant.

Permission to read is not permission to write. Permission to write is not permission to deploy. Each is granted on its own and can be withdrawn on its own, from Trust & control in Mission Control.

The authority map

Each branch is a separate, withdrawable grant. A missing grant stops execution; it is never assumed.

Your goal → ForgeOS

read repositorystructure, history and dependencies, so ForgeOS can plan against what is really there. This is where every connection starts.grant
write sourcea separate grant, scoped to a branch and to paths. Work outside the scope it was given does not run.separate
run testsbounded execution inside the workspace, never on your production systems.bounded
deploy previewits own grant, distinct from production.separate
deploy productionprotected. Releasing is never implied by permission to write code.protected
public trafficprotected, and separate from production activation.protected
customer dataoff unless you turn it on. Connecting a repository does not grant it.protected
spendno model provider runs work until you choose one and set a limit. Work stops at the limit rather than passing it.protected
payments & legalprotected actions. Not exercisable by the system on its own authority.protected
anything not grantedthe branch simply ends. Execution stops at the boundary; it is never assumed across it.
grantgiven at connection separateits own grant, scoped, revocable boundedruns only inside stated limits protectedan explicit decision, every time not granted — stops

Revoking a grant stops future work that depended on it rather than silently downgrading. What each grant is scoped to — branches, paths, environments, limits — is recorded with the grant and shown in Trust & control.

What happens at the edge

When ForgeOS lacks authority or evidence, it stops.

This is the behaviour that makes the rest of the page meaningful. A system that guesses when it is unsure cannot honestly promise anything about what it will not do.

  1. It stops and asks

    A goal that needs a decision moves to a stopped state and waits. It does not proceed on assumption and does not retry quietly.

  2. Review is not optional

    Finished work sits in review until a person accepts or rejects it, and the person who reviews cannot be the agent that built it.

  3. Scope is enforced, not requested

    Two pieces of work cannot claim overlapping paths in the same repository at the same time.

Evidence

The record of what happened is append-only and verifiable.

Every state change, approval, rejection and failure is written to a chain in which each entry carries a hash of the one before it. Editing history breaks the chain, and the check that detects it is the one reported on the status page.

Attributed decisions

An approval records who made it and what they were shown at the time, taken from what the interface actually rendered.

Readable history

The history of a goal is shown in Mission Control in plain language, alongside the raw recorded entries.

What evidence is not. When an agent submits finished work, its report of what it did is the agent's claim, not an independent verification. ForgeOS shows it as a claim. Check results come from runners, and where no runner is connected, no check is reported as passing — see status for what is connected here.

Your data

Tenant boundaries, and no customer data access by default.

Not pooled

Your repositories, goals, evidence and history belong to your tenant and are not shared across customers.

Customer data is its own grant

Access to customer data is not granted by connecting a repository. It is off unless you turn it on.

Providers are yours to choose

Which model providers may run work is a setting, per instance and per repository.

Withdrawable

Any grant can be revoked. Revoking stops future work that depended on it rather than silently downgrading.

Limits

What we do not claim.

Have a question this page did not answer?

Security reviews, procurement questionnaires and data questions all go to the same place.